Skip to main content
GET
Pool OHLCV Chart by Pool Address

Notes

  • Use timeframe with aggregate for custom intervals (e.g. minute?aggregate=15 for 15-minute OHLCV).
  • Timestamps use epoch/unix format (e.g. 1708850449).
  • Each call retrieves a max 6-month range — use before_timestamp for older data.
  • To page back without repeating a candle, set before_timestamp to the oldest timestamp in the previous response minus 1 (e.g. oldest 1794290400 → next before_timestamp=1794290399).
  • Each ohlcv_list element:
  • Intervals with no swaps are skipped by default. Set include_empty_intervals=true to fill gaps (OHLC = previous close, volume = 0).
Historical Access by Plan:
  • Basic: past 6 months
  • Analyst and above: September 2021 to present (depending on pool tracking start)

SDK Examples

New to the SDK? Install and authenticate the client first:
TypeScript | Python

Authorizations

x-cg-pro-api-key
string
header
required

Learn how to set up your API key

Path Parameters

network
string
default:eth
required

Network ID. *refers to /onchain/networks.

pool_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required

Pool contract address.

timeframe
enum<string>
default:day
required

Timeframe of the OHLCV chart.

Available options:
day,
hour,
minute,
second

Query Parameters

aggregate
string

Time period to aggregate each OHLCV. Available values (day): 1 Available values (hour): 1, 4, 12 Available values (minute): 1, 5, 15 Available values (second): 1, 15, 30 Default value: 1

before_timestamp
integer

Return OHLCV data up to and including the candle that contains this timestamp (integer seconds since epoch). That candle covers its full interval, so it may include trades after this timestamp.

limit
integer

Number of OHLCV results to return, maximum 1000. Default value: 100

currency
enum<string>

Return OHLCV in USD or quote token. Default: usd

Available options:
usd,
token
token
string

Return OHLCV for token, use this to invert the chart. Available values: base, quote, or token address. Default: base

include_empty_intervals
boolean

Include empty intervals with no trade data. Default: false

Response

200 - application/json

Pool OHLCV chart data

data
object
required
meta
object
required