Skip to main content
GET
Get OHLCV data for a pool pair.

Endpoint overview

Retrieve historical OHLCV for a pool at granular intervals. On Dev or Pro you can also chart a token without choosing a pool: token OHLCV returns USD candles aggregated across every pool the token trades in.

Plan limits

How far back you can query and how fine the candles can be depends on your plan. A request outside the limits returns 403 with a message naming the plan that lifts it. start, end and count_back are all checked against the window. A range that starts inside the window but reaches before it is trimmed to the window instead of rejected. Details on the rate limits page.

FAQs

1m, 5m, 10m, 15m, 30m, 1h, 6h, 12h, 24h with a max of 1000 points per request. Without a key only 1h and up are available; a free key adds 10m, 15m and 30m; 1m and 5m need Dev or Pro.
Provide start: a relative offset from now (-24h for the last 24 hours, -7d, -90m), an ISO timestamp, a date or Unix seconds. end is optional and takes the same formats. The range must fit your plan’s history window: 24 hours without a key, 7 days on a free key, 30 days on Dev, unlimited on Pro.
The request asked for more history or finer candles than your plan allows. The message in the body says which plan lifts the limit. Fix start, end, count_back or interval, or upgrade.
It flips the price ratio so the series reflects token1/token0 instead of token0/token1.

Tutorial: Get pool price history and OHLCV data

Pool candles with a working curl and Python script.

Path Parameters

network
string
required

Network slug or ID (e.g., 'solana'). You can find the list of supported networks with their IDs here: /networks.

pool_address
string
required

Unique pool address or identifier. Such as 0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b for WETH / USDT on ethereum.

Query Parameters

start
string
required

Start time for the OHLCV data. Required; "-24h" selects the last 24 hours. Accepted formats:

  • Relative offset from now (e.g., "-24h", "-7d", "-90m"; units: s, m, h, d)
  • Unix timestamp
  • RFC3339 timestamp (e.g., "2023-10-27T08:07:20Z")
  • Date (e.g., "2023-10-27", interpreted as 00:00:00 UTC)
Example:

"-24h"

end
string

End time for the OHLCV data. Accepted formats:

  • Relative offset from now (e.g., "-1h", "-2d")
  • Unix timestamp
  • RFC3339 timestamp (e.g., "2023-10-27T10:00:00Z")
  • Date (e.g., "2023-10-27", interpreted as 00:00:00 UTC)
Example:

"1741508640"

limit
integer<int32>
default:10

Maximum number of OHLCV records to return.

Required range: 1 <= x <= 1000
interval
enum<string>
default:24h

The time interval for each OHLCV record (candle).

Available options:
1m,
5m,
10m,
15m,
30m,
1h,
6h,
12h,
24h
inversed
boolean
default:false

Whether to invert the price ratio in OHLCV calculations (e.g., quote token vs. base token).

Response

A list of OHLCV records successfully retrieved.

time_open
string<date-time>
required

The opening timestamp of the OHLCV period.

Example:

"2023-10-27T10:00:00Z"

time_close
string<date-time>
required

The closing timestamp of the OHLCV period.

Example:

"2023-10-27T11:00:00Z"

open
number<double>
required

The opening price for the period.

Example:

1500.5

high
number<double>
required

The highest price reached during the period.

Example:

1525.75

low
number<double>
required

The lowest price reached during the period.

Example:

1495.25

close
number<double>
required

The closing price for the period.

Example:

1510

volume
integer<int64>
required

The total volume traded during the period.

Example:

1234567890123