Venue share over a window

GET

/chains/{chain}/venues

const url = 'https://api.getchord.xyz/v1/chains/avalanche/venues?days=30';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.getchord.xyz/v1/chains/avalanche/venues?days=30'

Per-venue volume, trades and share for 1–30 UTC days, with a daily series per venue. The first day of a young tape is partial.

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

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.

Query Parameters

days

integer

default: 30 >= 1 <= 30

Window length, in UTC days including today.

Responses

200

application/json

object

chain

integer

days

integer

since

Unix time, seconds, UTC.

integer

venues

Biggest first.

Array<object>

object

dex

string

volUsd

number

trades

integer

sharePct

number

series

Array<object>

object

day

integer

volUsd

number

trades

integer

tokens

integer

totals

object

volUsd

number

trades

integer

updatedAt

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

integer

Example

{
  "chain": 56,
  "days": 2,
  "since": 1790899200,
  "venues": [
    {
      "dex": "pancake_v3",
      "volUsd": 736112650.6777563,
      "trades": 1132649,
      "sharePct": 48.37984424468907,
      "series": [
        {
          "day": 1790899200,
          "volUsd": 580832396.3483784,
          "trades": 883596,
          "tokens": 576
        },
        {
          "day": 1790985600,
          "volUsd": 155280254.32937792,
          "trades": 249053,
          "tokens": 430
        }
      ]
    },
    {
      "dex": "pancake_infinity_cl",
      "volUsd": 315145928.03220856,
      "trades": 871769,
      "sharePct": 20.712469617942627,
      "series": [
        {
          "day": 1790899200,
          "volUsd": 249510270.7062881,
          "trades": 732838,
          "tokens": 166
        },
        {
          "day": 1790985600,
          "volUsd": 65635657.32592046,
          "trades": 138931,
          "tokens": 128
        }
      ]
    }
  ],
  "totals": {
    "volUsd": 1521527533.1494346,
    "trades": 2819913
  },
  "updatedAt": 1791021451942
}

400

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

application/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

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

application/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

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.

application/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"
}