# Every token traded in the last 24 hours

`GET https://api.getchord.xyz/v1/rh/tokens`

Source: https://getchord.xyz/docs/api-reference/operations/rhtokens/

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

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | no | integer (default `100`) |  |
| `sort` | query | no | `volume` · `trades` · `traders` · `change` (default `volume`) |  |
| `includeUnlisted` | query | no | `0` · `1` (default `0`) |  |

## Response 200

Example (captured from the live API):

```json
{
  "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**: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- **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.
