Errors

Error events (paginated)

Individual error events, paginated with a keyset cursor over (timestamp, req_id). Pass next_cursor from the previous response back as cursor to fetch the next page.

get/errors/events

Request

Base URL
https://api.tatum.io/v4/logs
URL
https://api.tatum.io/v4/logs/errors/events
Auth
API key in header x-api-key

Query parameters

cursorstring

Opaque keyset cursor from the previous page's next_cursor. Omit for the first page.

limitinteger

Target page size (1–1000). Defaults to the endpoint's page size when omitted.

A page may exceed this. req_id is not unique, so a page that would otherwise end in the middle of one request is extended with that request's remaining errors — up to 512 more rows. Ending mid-request is what would make the keyset cursor skip rows, so the overshoot is deliberate. Size a viewport on the rows actually returned, not on this value.

'5m'

'15m'

'1h'

'6h'

'24h'

'7d'

'14d'

'30d'

Relative look-back window. Ignored when from/to are supplied.

fromstring date-time

Inclusive window start, ISO-8601. Use together with to for an explicit range instead of time_range.

tostring date-time

Exclusive window end, ISO-8601. Defaults to now when only from is given.

searchstring

Free-text search across error fields (message, operation, ids). Control bytes are rejected; min 3 chars (text-index floor), max 128 chars.

'errors'

'usage'

Ranking dimension for aggregated views: errors orders by error volume, usage orders by total request volume.

filter[network][in]string[]

Include rows where network (blockchain network (chain-qualified)) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[network][nin]string[]

Exclude rows where network (blockchain network (chain-qualified)) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[chain][in]string[]

Include rows where chain (parent blockchain as recorded on the error; unrecognised values match no rows rather than erroring) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[chain][nin]string[]

Exclude rows where chain (parent blockchain as recorded on the error; unrecognised values match no rows rather than erroring) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[source][in]string[]

Include rows where source (error source / originating layer) is one of the given values. Repeat the parameter to pass multiple values.

filter[source][nin]string[]

Exclude rows where source (error source / originating layer) is none of the given values. Repeat the parameter to pass multiple values.

filter[operation][in]string[]

Include rows where operation (RPC method / operation) is one of the given values. Repeat the parameter to pass multiple values.

filter[operation][nin]string[]

Exclude rows where operation (RPC method / operation) is none of the given values. Repeat the parameter to pass multiple values.

filter[operation][contains]string

Include rows where operation (RPC method / operation) contains this substring (SQL LIKE '%value%').

filter[error_code][in]integer[]

Include rows where error_code (error / status code (JSON-RPC codes are negative)) is one of the given values. Repeat the parameter to pass multiple values.

filter[error_code][nin]integer[]

Exclude rows where error_code (error / status code (JSON-RPC codes are negative)) is none of the given values. Repeat the parameter to pass multiple values.

filter[error_code][between]integer[]

Include rows where error_code (error / status code (JSON-RPC codes are negative)) falls within an inclusive numeric range (SQL BETWEEN lo AND hi). Pass the parameter exactly twice: first the lower bound, then the upper bound.

filter[req_id][in]string[]

Include rows where req_id (request id — NOT unique, a JSON-RPC batch emits one error row per failing member) is one of the given values. Repeat the parameter to pass multiple values.

filter[event_id][in]string[]

Include rows where event_id (opaque per-event id from the events list (exact single-event lookup)) is one of the given values. Repeat the parameter to pass multiple values.

Response

A keyset-paginated page of individual error events.

next_cursorstring

Opaque cursor pointing at the row after the last one in data. Pass it back as cursor to retrieve the next page. Omitted when there are no more rows.

Example response

{
  "data": [
    {
      "event_id": "djE6MTc4Nzc0MzIxNjA1ODoyMkUzMzg3QUEwRjlEM0M2OnFncHptLTBmNWE1OTJm",
      "req_id": "a309e3a8edccb942-AMS",
      "timestamp": "2024-01-14T12:00:00.000Z",
      "operation": "eth_call",
      "error_code": 3,
      "error_message": "execution reverted",
      "error_data": "{\"code\":3,\"message\":\"execution reverted\",\"data\":\"0x08c379a0\"}",
      "request_context": "{\"params\":[\"0xabc...\",\"latest\"]}",
      "source": "blockchain-rpc",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
      "json_rpc_id": "1",
      "gateway_id": "1e06265e-f014-48ae-9cc6-94d046e4e04d",
      "interface_id": "ethereum-mainnet-json-rpc",
      "chain": "ethereum",
      "network": "ethereum-mainnet",
      "region": "europe-west4",
      "type": "jsonrpc_error_event"
    }
  ],
  "next_cursor": "eyJ0cyI6IjIwMjQtMDEtMTRUMTI6MDA6MDBaIiwicmVxX2lkIjoiYWJjLTEyMyJ9"
}

Changes

No recorded changes to this operation across all 1 revision of this API.