Executions

Sum what the selected executions were charged

Required API-key scope: executions:read. Takes the /executions filters. Each execution counts its latest fees_recorded ledger entry: gas, tool fees and priority fees. A summary covers at most 10,000 executions; a wider selection is refused (EXECUTION_SELECTION_TOO_LARGE), so narrow the filters, for example by onchain_created_after / onchain_created_before.

get /executions/charges

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Query Parameters

dag_object_id string | null
invoker string | null
status string | null
agent_object_id string | null
skill_id integer | null
task_object_id string | null
ids string | null

Comma-separated execution object ids, at most 100.

created_after string | null

Only include executions created at or after this RFC3339 timestamp.

created_before string | null

Only include executions created at or before this RFC3339 timestamp.

onchain_created_after string | null

Only include executions created on chain at or after this RFC3339 timestamp. created_after compares the time the row was stored; either on-chain bound leaves out a row with no on-chain time.

onchain_created_before string | null

Only include executions created on chain at or before this RFC3339 timestamp.

200application/json

What the selected executions were charged

charged_mist integer<int64> required

Gas, tool fees and priority fees together, in MIST.

executions integer<int64> required

Executions the filters select.

gas_fee_mist integer<int64> required

Gas alone. A ledger entry's gas_fee_mist also holds the tool fees.

priority_fee_mist integer<int64> required
tool_fee_mist integer<int64> required
unsettled_executions integer<int64> required

Of those, the ones still running, whose charge can still grow.

400

Invalid filter value

422

The filters select more than 10,000 executions (EXECUTION_SELECTION_TOO_LARGE); narrow them

500

Internal server error