Latest prints across the chain

GET

/chains/{chain}/prints

const url = 'https://api.getchord.xyz/v1/chains/avalanche/prints?limit=20';
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/prints?limit=20'

The newest swaps of tokens on the chain’s 24-hour board, newest first: a ticker, not a tape. It looks back ten minutes, skips trades under $1, keeps at most three prints a token so one busy pair does not fill it, and is shared for 10 seconds per chain. For one token’s full tape use /chains/{chain}/token/{address}/trades.

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

limit

integer

default: 20 >= 1 <= 50

Responses

200

application/json

object

chain

integer

prints

Array<object>

object

Transaction hash.

string

/^0x[a-fA-F0-9]{64}$/

logIndex

integer

block

integer

dex

string

token

EVM address, hex, case-insensitive.

string

/^0x[a-fA-F0-9]{40}$/

side

string

Allowed values: buy sell

usd

number

priceUsd

number

Unix time, seconds, UTC.

integer

symbol

From the board.

string

updatedAt

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

integer

Example

{
  "chain": 56,
  "prints": [
    {
      "tx": "0xfd35e2957d9660bddbef974222d8f4cf0960aa00ffbb560b437eeda98921124d",
      "logIndex": 322,
      "block": 125464252,
      "dex": "uniswap_v4",
      "token": "0xca750ef65f295bbecd685abf54e82caf297bdb61",
      "side": "sell",
      "usd": 374.6517520746725,
      "priceUsd": 196.98795013758274,
      "ts": 1791021448,
      "symbol": "SKHYB"
    },
    {
      "tx": "0x8eb8fb435526573f238417c155ebd7ad95ff73dae108eed0965db4bb7d84f7f3",
      "logIndex": 175,
      "block": 125464252,
      "dex": "pancake_infinity_cl",
      "token": "0x7ec43cf65f1663f820427c62a5780b8f2e25593a",
      "side": "buy",
      "usd": 109.53620868310122,
      "priceUsd": 0.052400254396345075,
      "ts": 1791021448,
      "symbol": "LAB"
    }
  ],
  "updatedAt": 1791021450656
}

400

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

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