Freshness and lag per dataset
Latest indexed block/day for each public dataset and how far it lags the chain head. Values may be up to 5 s old. If the current answer is unavailable (503) but the previous successful answer is at most 60 s old, that answer is returned as 200 with meta.stale = true and meta.stale_age_seconds (how long ago it was queried); checked_at and meta.refreshed_at keep the real check time. Without such an answer it is 503. A chain with no indexed block yet answers 409 not_indexed_yet (no indexed_through) instead.
Request
- Base URL: https://api.blockvectra.com/v1/data
- URL: https://api.blockvectra.com/v1/data/{chain}/status/freshness
- Auth: API key in header x-api-key
Path parameters
Chain identifier: the chain value of an entry in GET /chains (for example robinhood_mainnet), which lists every value this API accepts, i.e. the exact lowercase form of that entry's chain_slug. Matching is exact and case-sensitive; other spellings, aliases and numeric chain IDs are not accepted and return 404 not_found (unknown or not-public chain). What the chain serves differs per chain: see that entry's features and coverage.
Response
One row per tracked dataset.
Example response
{
"data": [
{
"dataset": "blocks",
"category": "raw",
"max_block_number": 2000000,
"max_day": null,
"max_time": "2026-09-28T03:41:07Z",
"seconds_behind": 0,
"blocks_behind": null,
"days_behind": null,
"checked_at": "2026-09-28T03:41:10Z"
}
],
"meta": {
"chain": "robinhood_mainnet",
"chain_slug": "ROBINHOOD_MAINNET",
"chain_external_id": "eip155:4663",
"refreshed_at": "2026-09-26T05:41:07Z"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.