Skip to main content
GET
/
networks
/
{network}
/
pools
/
{pool_address}
/
ohlcv
/
{timeframe}
Pool OHLCV chart by Pool Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": {
    "id": "bc786a99-7205-4c80-aaa1-b9634d97c926",
    "type": "ohlcv_request_response",
    "attributes": {
      "ohlcv_list": [
        [
          1712534400,
          3454.61590249189,
          3660.85954963415,
          3417.91885296256,
          3660.85954963415,
          306823.277031161
        ],
        [
          1712448000,
          3362.60273217873,
          3455.28884490954,
          3352.95305060685,
          3454.61590249189,
          242144.864784184
        ],
        [
          1712361600,
          3323.05578706056,
          3391.19811016133,
          3317.73497182435,
          3362.60273217873,
          273323.661682931
        ]
      ]
    }
  },
  "meta": {
    "base": {
      "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "name": "Wrapped Ether",
      "symbol": "WETH",
      "coingecko_coin_id": "weth"
    },
    "quote": {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "name": "Tether USD",
      "symbol": "USDT",
      "coingecko_coin_id": "tether"
    }
  }
}

​
Tips

  • You may use this endpoint to query the historical price and volume of a token.
  • You may select the timeframe with its respective aggregate to get the intended OHLCV data (e.g. minute?aggregate=15 for 15 minutes OHLCV).

​
Note

  • This endpoint uses epoch/unix format for its timestamp. Example: 1708850449.
  • Paid plan subscribers (Analyst plan & above) can access data from September 2021 to the present, depending on when the pool started tracking on GeckoTerminal.
    • If no earlier data is available, an empty response will be returned.
    • Each API call can only retrieve data for a maximum range of 6 months. To fetch older data, use the before_timestamp parameter to query in multiple requests.
  • Each OHLCV array (under “ohlcv_list”) consists of 6 elements in the following order:
    • Timestamp: The epoch/unix timestamp representing the start of the time interval.
    • Open: The opening price of the asset at the beginning of the interval.
    • High: The highest price reached during the interval.
    • Low: The lowest price reached during the interval.
    • Close: The price of the asset at the end of the interval.
    • Volume: The total trading volume of the asset during the interval.
  • Skipped Intervals: To ensure concise and relevant data, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded from the response.
    • Higher granularity timeframes (e.g. 1 minute) are more likely to skip intervals due to periods of inactivity, while lower granularity timeframes (e.g. daily) are less affected.
  • For include_empty_intervals param:
    • When false (default): Only intervals with trade data are returned.
    • When true: All requested intervals are returned, those with no trade data are populated as follows:
      • OHLC (Open, High, Low, Close) are all set to the Close price of the previous interval.
        • O = H = L = C = previous Close
      • Volume (V) is set to 0, reflecting no trade activity.
  • Cache/Update frequency: every 60 seconds.

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
pool_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required

pool contract address

Example:

"0x06da0fd433c1a5d7a4faa01111c044910a184553"

​
timeframe
enum<string>
required

timeframe of the OHLCV chart

Available options:
day,
hour,
minute

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 Default value: 1

​
before_timestamp
integer

return OHLCV data before this timestamp (integer seconds since epoch)

​
limit
integer

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

​
currency
enum<string>

return OHLCV in USD or quote token Default value: usd

Available options:
usd,
token
​
token
string
default:base

return OHLCV for token use this to invert the chart Available values: 'base', 'quote' or token address Default value: 'base'

​
include_empty_intervals
boolean
default:false

include empty intervals with no trade data, default: false

Response

200 - application/json

Get OHLCV data of a pool

​
data
object
​
meta
object