Chains API
GET/chains
Every listed chain: how far indexing has got and how far behind the tip it is, and the chain's last 24 hours: volume, trades, traders, new tokens and pools.
Parameters
None.
Response
| Field | Type | Meaning |
|---|---|---|
chains[] | array | One per listed chain: evm:56 (BSC), solana, evm:8453 (Base), evm:4663 (Robinhood Chain) and evm:1 (Ethereum). |
chains[].head | number | null | Latest block (on Solana, confirmed slot) seen at the tip. null when no listener has reported one in the last 2 minutes. |
chains[].listener, parser | { number, hash } | null | The last block fetched from the chain and queued, and the last block fully indexed: everything up to it is queryable. |
chains[].lag | number | null | Blocks (on Solana, slots) between head and parser; counted from listener while head is unknown. |
chains[].gaps | number | Block ranges deliberately skipped, for example when public RPC fell too far behind. Known gaps, never silent ones. |
chains[].indexedTime | number | null | Block time of parser, unix ms: Date.now() - indexedTime is how far behind real time the data is. |
chains[].indexedSince | number | null | Block time of the oldest indexed block, unix ms: history starts there. |
chains[].stats24h | object | volumeUsd, trades and traders (approximate, ~1%) of the chain's swaps over the last 24 h, each swap once; newTokens, tokens whose creation Aurelia saw; newPools, pools created in the chain's blocks of the last 24 h (null without such a block). |
updatedAt | number | When the answer was built, unix ms. |
Example
Captured 2026-09-28 18:03 UTC on a test instance.
curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/chains'{
"chains": [
{
"chain": "evm:56",
"head": null,
"listener": null,
"parser": {
"number": 1000750,
"hash": "0x00000000000000000000000000000000000000000000000000000000000f452e"
},
"gaps": 0,
"lag": null,
"indexedTime": 1790618578665,
"indexedSince": 1790546261920,
"stats24h": {
"volumeUsd": 67218,
"trades": 131,
"traders": 8,
"newTokens": 3,
"newPools": 4
}
},
{
"chain": "solana",
"head": null,
"listener": null,
"parser": {
"number": 449600022,
"hash": "5q3oRWqw8jV5Wdw7vbCE9Bn1MG4xyCZjK3VTk6UGk26Y"
},
"gaps": 0,
"lag": null,
"indexedTime": 1790618141920,
"indexedSince": 1790546261920,
"stats24h": {
"volumeUsd": 31848,
"trades": 61,
"traders": 4,
"newTokens": 1,
"newPools": 1
}
}
],
"updatedAt": 1790618612055
}Notes
- Cached 15 s.