Error breakdown by source
Returns error counts grouped by originating source over the window.
Request
- Base URLhttps://api.tatum.io/v4/logs
- URLhttps://api.tatum.io/v4/logs/errors/breakdown
- AuthAPI key in header x-api-key
Query parameters
Relative look-back window. Ignored when from/to are supplied.
Inclusive window start, ISO-8601. Use together with to for an explicit range instead of time_range.
Exclusive window end, ISO-8601. Defaults to now when only from is given.
Free-text search across error fields (message, operation, ids). Control bytes are rejected; min 3 chars (text-index floor), max 128 chars.
Ranking dimension for aggregated views: errors orders by error volume, usage orders by total request volume.
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).
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).
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).
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).
Include rows where source (error source / originating layer) is one of the given values. Repeat the parameter to pass multiple values.
Exclude rows where source (error source / originating layer) is none of the given values. Repeat the parameter to pass multiple values.
Include rows where operation (RPC method / operation) is one of the given values. Repeat the parameter to pass multiple values.
Exclude rows where operation (RPC method / operation) is none of the given values. Repeat the parameter to pass multiple values.
Include rows where operation (RPC method / operation) contains this substring (SQL LIKE '%value%').
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.
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.
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.
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.
Response
Error breakdown by source, network/chain, and operation.
Example response
{
"sources": [
{
"source": "blockchain-rpc",
"total": 1538,
"sparkline": {
"points": [
{
"timestamp": "2024-01-14T12:00:00.000Z",
"value": 42
}
],
"total": 1538
}
}
],
"networks": [
{
"network": "ethereum-mainnet",
"chain": "ethereum",
"total": 1538
}
],
"operations": [
{
"operation": "eth_call",
"total": 1538
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.