# One token: hourly tape and venue split

`GET https://api.getchord.xyz/v1/arc/token/{address}`

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

The token row plus an hourly series (1–720 hours) and the venue split for the window. Feeds Chord's token page header, volume bars and venue table. A token with no 24-hour row comes back as `{ address, listed: false }`.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `address` | path | yes | string |  |
| `hours` | query | no | integer (default `168`) | Hourly buckets to return. |

## Response 200

Example (captured from the live API):

```json
{
  "chain": 5042,
  "token": {
    "address": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
    "symbol": "cirBTC",
    "name": "cirBTC",
    "decimals": 8,
    "logoURI": "https://api.getchord.xyz/v1/logo/5042/0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
    "tags": [],
    "listed": true,
    "priceUsd": 80423.22925858323,
    "change24hPct": -1.0826513878648192,
    "volume24h": 5689551.810770997,
    "buyVolume24h": 2765666.247710997,
    "sellVolume24h": 2923885.56306,
    "trades24h": 19472,
    "buys24h": 10554,
    "sells24h": 8918,
    "traders": 3203,
    "lastTradeTs": 1789891845,
    "totalSupply": 336.81495614,
    "marketCapUsd": 27087746.435366876,
    "pools": {
      "v3": 21,
      "v2": 5,
      "v4": 483,
      "byDex": {
        "uniswap_v3": 10,
        "v2fork_a2448256": 1,
        "slipstream_fork": 2,
        "v3fork_5bfbceb7": 6,
        "v3fork_bb74f231": 2,
        "v2fork_49aa1c63": 2,
        "v3fork_711492df": 1,
        "sushi_v2": 2,
        "uniswap_v4": 483
      }
    },
    "routable": true,
    "logoUriRaw": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/bitcoin/info/logo.png"
  },
  "hours": 2,
  "series": [
    {
      "hour": 1789887600,
      "volUsd": 109750.71408699999,
      "buyUsd": 59532.95500899996,
      "sellUsd": 50217.759078,
      "trades": 465,
      "buys": 247,
      "sells": 218,
      "priceLast": 80315.09208021293
    },
    {
      "hour": 1789891200,
      "volUsd": 14523.166291000001,
      "buyUsd": 13047.791779000001,
      "sellUsd": 1475.374512,
      "trades": 32,
      "buys": 23,
      "sells": 9,
      "priceLast": 80404.02465976504
    }
  ],
  "byDex": [
    {
      "dex": "uniswap_v3",
      "volUsd": 100905.00920399999,
      "trades": 460,
      "sharePct": 81.1956695140446
    },
    {
      "dex": "slipstream_fork",
      "volUsd": 23247.566194,
      "trades": 28,
      "sharePct": 18.706719483843752
    }
  ],
  "updatedAt": 1789891855212
}
```

- **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.