# Candles

`GET https://api.getchord.xyz/v1/tokens/chart/{address}`

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

OHLCV candles from Chord's own tape, address-keyed — one call serves Arc and Robinhood Chain tokens (addresses cannot collide). 200 candles per page; `before` pages backwards for unlimited history. A token that is not on a curated list and not a side of an indexed pool is `404 UNKNOWN_TOKEN`. For live candles subscribe on `/v1/ws/live` (see Streaming).

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `address` | path | yes | string |  |
| `tf` | query | no | `1m` · `5m` · `15m` · `1h` · `4h` · `1d` · `1w` (default `1h`) | Timeframe. |
| `before` | query | no | integer | Return the 200 candles before this time (paging). |

## Response 200

Example (captured from the live API):

```json
{
  "candles": [
    {
      "t": 1789520400,
      "o": 76161.46230007616,
      "h": 93752.28222071448,
      "l": 73286.91828508611,
      "c": 73301.06410779823,
      "v": 22676.53
    },
    {
      "t": 1789524000,
      "o": 73332.39663202444,
      "h": 75694.61170208515,
      "l": 73332.39663202444,
      "c": 75694.61170208515,
      "v": 173955.23
    }
  ],
  "tf": "1h",
  "source": "db"
}
```

- **400**: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- **404**: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).
- **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.