> ## Documentation Index
> Fetch the complete documentation index at: https://docs.serialized.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Candles (OHLCV)

> Chart-ready candles from 1s to 1d, multi-pool aggregation (≤50 pools), wick-outlier clamping and candle connecting included. On Base, the forming candle includes preconfirmed (flashblocks) swaps ~2.5s before block commit.

`GET /v1/token/ohlcv` · **5 credits**

Chart-ready candles from 1s to 1d, multi-pool aggregation (≤50 pools), wick-outlier clamping and candle connecting included. On Base, the forming candle includes preconfirmed (flashblocks) swaps \~2.5s before block commit.

<ParamField query="chain" type="string" required>
  Public chain id - `evm:<id>` or `solana` (`solana:solana` accepted). Example: `evm:8453`
</ParamField>

<ParamField query="address" type="string" required>
  Token address (EVM hex, case-insensitive). Example: `0x4ed4e862860bed51a9570b96d89af5e1b0efefed`
</ParamField>

<ParamField query="pools" type="string" required>
  CSV of pool addresses (≤50). Example: `0x0ca6485b7e9cf814a3fd09d81672b07323535b64`
</ParamField>

<ParamField query="interval" type="string">
  1s|5s|15s|30s|1m|3m|5m|15m|30m|1h|2h|4h|6h|12h|1d|1w|1M (default 5m). Example: `1h`
</ParamField>

<ParamField query="limit" type="integer">
  1-500, default 200. Example: `24`
</ParamField>

<ParamField query="endTime" type="integer">
  Unix seconds, inclusive. Paginate back with prev `meta.oldestTime - 1` while `meta.hasMore`.
</ParamField>

<ParamField query="quote" type="string">
  `native` (default) or `usd` (Solana) - usd converts each candle at its bucket's SOL/USD rate from our in-house minute-grade price history. Example: `usd`
</ParamField>

<Note>Prices are native-quoted by default (`meta.quote: "native"`). On Solana, pass `quote=usd` for USD candles; otherwise multiply by the native USD price for USD charts.</Note>

<Note>Historical pages are immutable and cached - pagination is fast and deterministic.</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.serialized.trade/v1/token/ohlcv?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&pools=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&interval=1h&limit=24' \
    -H 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "time": 1786694400,
        "open": 5.4670969692593e-7,
        "high": 5.4748839531073e-7,
        "low": 5.4670969692593e-7,
        "close": 5.4748839531073e-7,
        "volume": 0.22006777918571868
      },
      {
        "time": 1786701600,
        "open": 5.4748839531073e-7,
        "high": 5.4748839531073e-7,
        "low": 5.4747109625568e-7,
        "close": 5.4747109625568e-7,
        "volume": 0.004838309934296527
      },
      {
        "time": 1786716000,
        "open": 5.4747109625568e-7,
        "high": 5.4747124708872e-7,
        "low": 5.4747109625568e-7,
        "close": 5.4747124708872e-7,
        "volume": 0.000042612402192036
      }
    ],
    "meta": {
      "asOf": 1786724320540,
      "interval": "1h",
      "count": 24,
      "oldestTime": 1786586400,
      "newestTime": 1786716000,
      "hasMore": true,
      "quote": "native"
    }
  }
  ```
</ResponseExample>