Skip to content
ChordChordChord Docs

Every token traded in the last 24 hours

GET
/rh/tokens
curl --request GET \
  --url 'https://api.getchord.xyz/v1/rh/tokens?limit=100&sort=volume&includeUnlisted=0'

Price, change, volume split, trade counts and attributed traders. Unlisted tokens (no curated metadata or logo) are hidden unless asked for. Chain 4663 only; takes no chain parameter. Served from Chord’s rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 100 >= 1 <= 200
sort
string
default: volume
Allowed values: volume trades traders change
includeUnlisted
integer
0
Allowed values: 0 1

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
Allowed value: 4663
sinceHour
integer
tradersSince
integer
sort
string
tokens
Array<object>

One token on Robinhood Chain with its 24-hour tape.

object
address

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
symbol
string
name
string
decimals
integer
logoURI
string | null
tags

stock, bridged, stablecoin, …

Array<string>
listed
boolean
priceUsd
number | null
change24hPct
number | null
liquidityUsd
number | null
volume24h
number
buyVolume24h
number
sellVolume24h
number
trades24h
integer
buys24h
integer
sells24h
integer
traders

Attributed wallets only.

integer
lastTradeTs

Unix time, seconds, UTC.

integer
total
integer
updatedAt

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

integer
Example
{
  "chain": 4663,
  "sinceHour": 1789808400,
  "tradersSince": 1789776000,
  "sort": "volume",
  "tokens": [
    {
      "address": "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73",
      "symbol": "WETH",
      "name": "WETH",
      "decimals": 18,
      "logoURI": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
      "tags": [
        "bridged"
      ],
      "listed": true,
      "priceUsd": 2580.1259797979797,
      "change24hPct": -2.421961053968613,
      "liquidityUsd": null,
      "volume24h": 305214685.46276,
      "buyVolume24h": 150250793.83089906,
      "sellVolume24h": 154963891.63186103,
      "trades24h": 431734,
      "buys24h": 221381,
      "sells24h": 210353,
      "traders": 19755,
      "lastTradeTs": 1789891402
    },
    {
      "address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
      "symbol": "NVDA",
      "name": "NVIDIA • Robinhood Token",
      "decimals": 18,
      "logoURI": "https://cdn.robinhood.com/ncw_assets/logos/0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec.png",
      "tags": [
        "stock"
      ],
      "listed": true,
      "priceUsd": 220.97693371148938,
      "change24hPct": -0.7107543259553206,
      "liquidityUsd": 7508320,
      "volume24h": 34504046.378991455,
      "buyVolume24h": 16798001.15787153,
      "sellVolume24h": 17706045.221119925,
      "trades24h": 103172,
      "buys24h": 52577,
      "sells24h": 50595,
      "traders": 5056,
      "lastTradeTs": 1789891401
    }
  ],
  "total": 357,
  "updatedAt": 1789891868895
}

400

Section titled “400”

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

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”

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). 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"
}