Token candles API

GET/tokens/:chain/:address/candles

OHLC bars of a token, in USD or in its quote token, from the pool that charts it. The answer names that pool. A price history is the bars' closes.

Candles belong to a pool, not a token. Token candles chart a token in its chart pool and name it; pool candles chart any pool. A price history is the bars' closes. Keep the newest bar moving with the candles channel.

Parameters

Name	In	Type	Default	Allowed values
`chain`	path	string	required	`evm:56` (BSC), `solana`, `evm:8453` (Base), `evm:4663` (Robinhood Chain) or `evm:1` (Ethereum)
`address`	path	string	required	Token address (BSC) or mint (Solana)
`res`	query	string	`1m`	`1m`, `5m`, `15m`, `1h`, `4h`, `1d`
`from`	query	integer	`to` − 500 bars	Unix seconds
`to`	query	integer	now	Unix seconds, ≥ `from`; at most 5,000 bars from `from`
`currency`	query	string	`usd`	`usd`, `quote`
`fill`	query	string	off	`1` or `true`: repeat the previous close through empty intervals

Response

Field	Type	Meaning
`chain`, `pool`, `res`, `currency`	string	`pool` is the pool the bars come from; the rest is the request, echoed.
`token`	string	The token asked for.
`bars[]`	array	Ascending, `from` ≤ `t` ≤ `to`.
`t`	number	Bar start, unix seconds, aligned to UTC multiples of `res`.
`o`, `h`, `l`, `c`	number	Open, high, low, close. Each bar opens at the previous bar's close.
`v`	number	USD volume, in both currencies.
`n`	number	Trades: priced ones in `usd`, all of them in `quote`.

Example

Captured 2026-09-28 18:03 UTC on a test instance, trimmed to 3 bars.

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/tokens/evm:56/0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777/candles?res=1h&from=1790611200&to=1790618400'

{
  "chain": "evm:56",
  "pool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
  "res": "1h",
  "currency": "usd",
  "bars": [
    {
      "t": 1790611200,
      "o": 0.006,
      "h": 0.006122448979591836,
      "l": 0.006,
      "c": 0.006122448979591836,
      "v": 36,
      "n": 5
    },
    {
      "t": 1790614800,
      "o": 0.006122448979591836,
      "h": 0.006122448979591836,
      "l": 0.006,
      "c": 0.006,
      "v": 18,
      "n": 3
    },
    {
      "t": 1790618400,
      "o": 0.006,
      "h": 0.006,
      "l": 0.006,
      "c": 0.006,
      "v": 600,
      "n": 2
    }
  ],
  "token": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777"
}

Notes

The pool is the token's chart pool, where it was the base with the most USD volume in the last 24 h, as its price picks it. Without a trade in 24 h, the pool where it was the base with the most volume ever.
Bars, caching and parameters are those of pool candles: unix seconds, at most 5,000 bars a request.
A pool's candles price its base, so a token that is the base of no pool, such as USDC, answers 422. 404 {"error":"unknown token"} for a token Aurelia has never stored.
Keep the newest bar moving with the candles channel.

Try it in the interactive docs Create a free account