Access chart
Returns bucketed request counts for chart rendering: per-status-class bands, a true total, and a per-status-code breakdown for the tooltip.
Bucket width scales with the requested window, down to 1 ms, and is reported once as bucket_ms; buckets are gap-filled, so an interval with no traffic is still emitted with zeroes. Accepts every filter[...] field /access/events does except event_id, plus search.
A window resolving to a sub-minute bucket, a filter[req_id] or a search is answered from the raw table, whose read is bounded; when the bound trips the response is capped: true with no buckets.
Request
- Base URLhttps://api.tatum.io/v4/logs
- URLhttps://api.tatum.io/v4/logs/access/chart
- 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 substring match against the request URI. Matched with lower(uri) LIKE '%needle%', so separators (/, -, _, ., :) are fine. Control bytes are rejected; min 3 chars, max 128.
On an aggregate endpoint a search is answered from the raw table, whose read is bounded: past ACCESS_RAW_ROW_CAP rows scanned the response is capped: true. The floor is not cosmetic: access_logs_v1 has no index on uri, so a 1–2 char needle scans the owner's slice for a match that would hit nearly every row.
Include rows where status_code (HTTP response status code) is one of the given values. Repeat the parameter to pass multiple values.
Exclude rows where status_code (HTTP response status code) is none of the given values. Repeat the parameter to pass multiple values.
Include rows where status_code (HTTP response status code) 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 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 (blockchain — the parent of network) 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 (blockchain — the parent of network) 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 method (HTTP / RPC method) is one of the given values. Repeat the parameter to pass multiple values.
Exclude rows where method (HTTP / RPC method) is none of the given values. Repeat the parameter to pass multiple values.
Include rows where method (HTTP / RPC method) contains this substring (SQL LIKE '%value%').
Include rows where remote_ip (client IP address, IPv4 or IPv6 (IPv6 matched in canonical form)) is one of the given values. Repeat the parameter to pass multiple values.
Exclude rows where remote_ip (client IP address, IPv4 or IPv6 (IPv6 matched in canonical form)) is none of the given values. Repeat the parameter to pass multiple values.
Include rows where source (traffic source / attribution channel) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no source (unattributed traffic).
Exclude rows where source (traffic source / attribution channel) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no source (unattributed traffic).
Include rows where req_id (request id — NOT unique, may match unrelated requests) is one of the given values. Repeat the parameter to pass multiple values.
Response
Bucketed request counts split by HTTP status class and status code.
Example response
{
"buckets": [
{
"timestamp": "2024-01-14T12:00:00.000Z",
"status_2xx": 1503,
"status_3xx": 7,
"status_4xx": 24,
"status_5xx": 3,
"total": 1538,
"by_status": [
{
"status_code": 200,
"requests": 1503
},
{
"status_code": 404,
"requests": 24
},
{
"status_code": 301,
"requests": 7
},
{
"status_code": 500,
"requests": 3
},
{
"status_code": 100,
"requests": 1
}
],
"other_requests": 0,
"bytes_sent": 1574912,
"latency_p50_ms": 118,
"latency_p90_ms": 340,
"latency_p95_ms": 512
}
],
"bucket_ms": 300000
}Changes
No recorded changes to this operation across all 1 revision of this API.