Skip to main content
GET
/
networks
/
{network}
/
pools
/
{pool_address}
/
ohlcv
/
{timeframe}
Pool OHLCV chart by Pool Address
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe} \
  --header 'x-cg-pro-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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).

Authorizations

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

Path Parameters

​
network
string
default:eth
required
Example:
​
pool_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required
Example:
​
timeframe
enum<string>
required
Available options:
day,
hour,
minute,
second

Query Parameters

​
aggregate
string
​
before_timestamp
integer
​
limit
integer
​
currency
enum<string>
Available options:
usd,
token
​
token
string
default:base
​
include_empty_intervals
boolean
default:false

Response

200 - application/json
​
data
object
​
meta
object