Data Freshness API
Check the latest block height, day, and head-lag metrics for each public dataset.
Endpoints
| Method | Path | Description | CU / Call | USD / 1M Calls | Calls per free cycle (approx.) |
|---|---|---|---|---|---|
| GET | /{chain}/status/freshness | Freshness and lag per dataset | 1 | $0.10 | 30,000,000 |
Free plan: all keys in your account share an average of 25 calls per second.
Response fields
GET/{chain}/status/freshness
| Field | Type |
|---|---|
| dataset | string |
| category | string |
| max_block_number | integer | null |
| max_day | string | null |
| max_time | string | null |
| seconds_behind | integer | null |
| blocks_behind | integer | null |
| days_behind | integer | null |
| coverage_from_block | integer | null |
| coverage_to_block | integer | null |
| coverage_complete | boolean |
| checked_at | string |
Available on Chains
Quick example
curl -s "https://api.blockvectra.com/v1/data/arb_mainnet/status/freshness" -H "x-api-key: {api_key}"Documentation
Try this dataset for free
Get 30M CU on sign-up, refilled every 30 days.
Data API bills only successful responses.