Events

List indexed events, newest first

Required API-key scope: events:read. The durable counterpart to /events/stream: the same decoded events, ordered newest-first by events.id (insertion order, which is checkpoint order), with the checkpoint timestamp each frame on the stream lacks.

Optional filters: kinds (comma-separated, Event suffix optional), sender (hex address), tx_digest, created_after / created_before (RFC3339, inclusive, against onchain_at), page_token, page_size.

Only kinds the pinned SDK can decode are listed or counted — the indexer stores every event matching the wrapper type, which is strictly more than the catalog models. A page can still come back one or two items short of page_size when a row is permanently undecodable; next_token counts rows scanned rather than items returned, so paging never skips.

get /events

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

kinds string | null

Comma-separated event kind names (e.g. WalkAdvancedEvent,DAGCreatedEvent). The trailing Event suffix is optional. Every name must be in the decodable event catalog; an unknown one is rejected rather than silently matching nothing. Omit for every kind.

sender string | null

Hex address of the transaction sender that emitted the event.

tx_digest string | null

Every event emitted by one transaction.

created_after string | null

Only include events whose checkpoint timestamp is at or after this RFC3339 instant. Filters onchain_at, so rows indexed before on-chain timestamps existed (null) are excluded by either bound — there is no honest way to place an event with no time.

created_before string | null

Only include events whose checkpoint timestamp is at or before this RFC3339 instant.

page_token integer | null

Opaque token representing the page offset. Omit for the first page.

page_size integer | null

Maximum number of items to return. Defaults to 20.

200application/json

Paginated list of decoded events

items object[] required
id integer<int64> required

Monotonic events.id. Doubles as the stream's last_event_id cursor, so a client can hand the newest id here straight to /events/stream and continue without a gap.

kind string required

Canonical event kind name, e.g. DAGCreatedEvent.

onchain_at string | null

Checkpoint timestamp of the emitting transaction; null for rows indexed before the column existed, until a backfill re-fetches them.

payload any required

The fully decoded NexusEvent (id, generics, data, distribution).

sender_address string required

Hex-encoded address of the transaction sender.

tx_digest string required
metadata object required

Pagination metadata included in every listing response.

next_token integer | null

Token to pass as page_token to retrieve the next page. null means there are no more pages.

total_items integer<int64> required

Total number of items across all pages.

400

kinds names an event absent from the decodable catalog, or a filter value is invalid

401

Missing or invalid API key.

403

API key lacks the events:read scope.

500

Internal server error