Skip to content
ChordChordChord Docs

Chain totals

GET
/chains/{chain}/overview
curl --request GET \
  --url https://api.getchord.xyz/v1/chains/avalanche/overview

Last 24 hours (volume, swaps, tokens, venues), distinct wallets per UTC day, venue share, 24 hourly buckets and up to 14 daily rows.

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”.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
chain
required
string
Allowed values: avalanche base bnb arbitrum ethereum 43114 8453 56 42161 1

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.

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
last24h
object
volUsd
number
swaps
integer
tokens
integer
venues
integer
sinceHour

Start of the window.

integer
wallets

Calendar-day counts, never a sliding 24 hours. Null = no day row yet.

object
day

Unix time, seconds, UTC.

integer
today

Distinct attributed wallets so far today (UTC); partial.

integer | null
yesterday
integer | null
venues24h

Biggest first.

Array<object>

One venue’s share of the window.

object
dex

Venue id.

string
volUsd
number
trades
integer
tokens
integer
sharePct
number
hourly24

Oldest first.

Array<object>
object
hour
integer
volUsd
number
swaps
integer
daily

Up to 14 days, oldest first. The first day of a young tape is partial.

Array<object>
object
day
integer
swaps
integer
volUsd
number
tokens
integer
wallets

Attributed wallets only.

integer
venues
integer
coverage

When the rollup last ran.

object
recentAt

Unix time, seconds, UTC.

integer
stale

True when the last rollup pass is more than 30 minutes old.

boolean
ingestFloor

The tape’s ingest floor. BNB Chain runs at $100 today; Avalanche and Base at 0.

object
minTradeUsd

Trades under this USD value (at index time) are not in the index, so every count, volume and candle covers trades at or above it. 0 = every priced trade.

number
history

Floors in force over time, oldest first. Empty when the chain was never floored. Raising a floor does not remove older, smaller rows.

Array<object>
object
usd

Floor in force.

number
fromTs

Unix time, seconds, UTC.

integer
updatedAt

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

integer
Example
{
  "chain": 56,
  "last24h": {
    "volUsd": 1014438316.7825807,
    "swaps": 1725125,
    "tokens": 4466,
    "venues": 57,
    "sinceHour": 1790935200
  },
  "wallets": {
    "day": 1790985600,
    "today": 52979,
    "yesterday": 110488
  },
  "venues24h": [
    {
      "dex": "pancake_v3",
      "volUsd": 507002171.3116286,
      "trades": 802437,
      "tokens": 581,
      "sharePct": 49.97861012581327
    },
    {
      "dex": "pancake_v2",
      "volUsd": 243172605.08525935,
      "trades": 299915,
      "tokens": 2950,
      "sharePct": 23.971157345131836
    }
  ],
  "hourly24": [
    {
      "hour": 1790935200,
      "volUsd": 32855754.23107098,
      "swaps": 62895
    },
    {
      "hour": 1790938800,
      "volUsd": 37902743.56465449,
      "swaps": 74862
    }
  ],
  "daily": [
    {
      "day": 1790726400,
      "swaps": 352759,
      "volUsd": 201620870.33918935,
      "tokens": 1711,
      "wallets": 24991,
      "venues": 31
    },
    {
      "day": 1790812800,
      "swaps": 2017913,
      "volUsd": 1025889560.5733465,
      "tokens": 4523,
      "wallets": 95849,
      "venues": 55
    }
  ],
  "coverage": {
    "recentAt": 1791020331,
    "stale": false
  },
  "ingestFloor": {
    "minTradeUsd": 100,
    "history": [
      {
        "usd": 100,
        "fromTs": 1790789196
      }
    ]
  },
  "updatedAt": 1791020818773
}

400

Section titled “400”

UNSUPPORTED_CHAIN (unknown chain, a chain with its own routes, or a chain not served to this caller yet).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

429

Section titled “429”

Over the per-minute limit (RATE_LIMIT_EXCEEDED). Read X-RateLimit-Reset and back off.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

503

Section titled “503”

NOT_READY (the chain’s rollup has not run on this deployment yet) or CHAIN_DATA_UNAVAILABLE (the store could not be read). Retry later; do not treat it as an empty answer.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}