Curated token list

GET

/tokens

const url = 'https://api.getchord.xyz/v1/tokens?chain=5042';
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/tokens?chain=5042'

Metadata for the tokens Chord routes and labels: address, symbol, name, decimals, logo, tags. On Arc the list leads with the USDC predeploy (the gas token’s ERC-20 face) and EURC; on Robinhood Chain with ETH, WETH, USDG and every tokenized stock. Read decimals here instead of assuming 18.

Parameters

Query Parameters

chain

required

integer

default: 143

Allowed values: 5042 4663 143 43114 8453 56 42161 1

Chain id: 5042 Arc · 4663 Robinhood Chain · 143 Monad · 43114 Avalanche C-Chain · 8453 Base · 56 BNB Chain · 42161 Arbitrum One · 1 Ethereum. Omitted = 143.

Responses

200

application/json

object

tokens

Array<object>

object

address

EVM address, hex, case-insensitive.

string

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

symbol

string

name

string

decimals

integer

logoURI

string | null

logoUriRaw

string | null

verified

boolean

tags

Array<string>

liquidityUsd

number | null

Example

{
  "tokens": [
    {
      "address": "0x3600000000000000000000000000000000000000",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "logoURI": "https://api.nullterminal.xyz/v1/logo/5042/0x3600000000000000000000000000000000000000",
      "verified": true,
      "tags": [
        "stablecoin"
      ],
      "logoUriRaw": "https://assets.coingecko.com/coins/images/6319/small/usdc.png"
    },
    {
      "address": "0xbef5f6d51cb62b58e6a8f77868681825c6fe21c1",
      "symbol": "EURC",
      "name": "Euro Coin",
      "decimals": 6,
      "logoURI": "https://api.nullterminal.xyz/v1/logo/5042/0xbef5f6d51cb62b58e6a8f77868681825c6fe21c1",
      "verified": true,
      "tags": [
        "stablecoin",
        "fx"
      ],
      "logoUriRaw": "https://assets.coingecko.com/coins/images/26045/small/euro.png"
    }
  ]
}

400

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

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