Avalanche, Base, BNB Chain

Rollup freshness and coverage

Is the chain's rollup fresh, how far back it reaches, whether the tape and the public flag are on, where the raw tape is cut, and the ingest floor. Answers 200 even before the first rollup pass (recentAt is then null). Check it before trusting a quiet number.

Chain-keyed data for Avalanche C-Chain, Base and BNB Chain, served from Chord's rollup tables for the chain (every swap summed by hour, token and venue). Only the trade tape, the prints ticker and the wallet read raw rows, scoped to one token or one wallet and bounded.

  • Access. No key needed while the chain is public (all three are today). A chain whose tape is off, or that is not public yet, answers 400 UNSUPPORTED_CHAIN ("chain N is not served yet") unless the request carries an X-API-Key; those answers are sent Cache-Control: private.
  • Ingest floor. Every count, volume and print covers trades at or above the chain's floor, returned as ingestFloor. BNB Chain runs at $100 today; Avalanche and Base at 0.
  • Readiness. 503 NOT_READY until the chain's rollup has run on this deployment; 503 CHAIN_DATA_UNAVAILABLE when the store cannot be read. Never treat either as "no trades".
get/chains/{chain}/status

Request

  • Base URL: https://api.getchord.xyz/v1
  • URL: https://api.getchord.xyz/v1/chains/{chain}/status
  • Auth: none declared

Path parameters

chain'avalanche' | 'base' | 'bnb' | 'arbitrum' | 'ethereum' | '43114' | '8453' | '56' | '42161' | '1' required

The chain, by key or id: avalanche or 43114, base or 8453, bnb or 56, arbitrum or 42161, ethereum or 1 (case-insensitive). Arc, Robinhood Chain and Monad are refused with 400 UNSUPPORTED_CHAIN and a pointer to their own routes.

Response

chaininteger

Registry id.

enabledboolean

The rollup and the tape both run.

tapeboolean

The chain's trade tape runs.

publicboolean

Served to callers without a key.

recentAtinteger nullable

Unix time, seconds, UTC.

staleSecinteger nullable

Seconds since the last rollup pass.

floorHourinteger nullable

Oldest hour the backfill has rolled.

genesisHourinteger nullable

The chain's first indexed hour, when this server knows it; often null.

backfillCompleteboolean

True once the backfill has reached the first indexed hour.

retentionCutoffDayinteger nullable

UTC day start. Raw trades before it are retired from the database (about 3 days on BNB Chain and Base, 7 on Avalanche today); the hourly and daily rollups keep their history.

updatedAtinteger

Unix time, milliseconds — when the server built this answer.

Changes

No recorded changes to this operation across all 2 revisions of this API.