Reference price from CoinGecko

GET

/chains/{chain}/token/{address}/ref-price

const url = 'https://api.getchord.xyz/v1/chains/avalanche/token/example/ref-price';
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/token/example/ref-price

CoinGecko’s price and 24-hour change for a token by contract address, for a token Chord’s index has not seen trade (or to cross-check one it has). Not Chord’s own data: the answer says so in source. Cached two minutes; ageS is the age of the cached CoinGecko answer.

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.

address

required

EVM address, hex, case-insensitive.

string

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

Token address. The zero address means the chain’s wrapped native token (WAVAX, WETH, WBNB).

Responses

200

application/json

object

chain

integer

address

EVM address, hex, case-insensitive.

string

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

priceUsd

number

change24hPct

number | null

source

string

Allowed value: coingecko

ageS

Seconds since CoinGecko answered.

integer

Example

{
  "chain": 56,
  "address": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c",
  "priceUsd": 84397,
  "change24hPct": -2.11,
  "source": "coingecko",
  "ageS": 0
}

400

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

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

404

NOT_LISTED: CoinGecko does not list this token on this chain.

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

UNAVAILABLE: CoinGecko did not answer. Retry later.

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