Skip to main content
GET
/
networks
/
{network}
/
tokens
/
{token_address}
/
ohlcv
/
{timeframe}
💼 Token OHLCV chart by Token Address
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_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"
    }
  }
}

​
Note

  • This endpoint will return OHLCV data of the most liquid pool of the specified token. You may use this endpoint Top Pools by Token Address to check the top pools of a token.
  • 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:solana
required

network ID *refers to /networks

Example:

"solana"

​
token_address
string
default:So11111111111111111111111111111111111111112
required

token contract address

Example:

"So11111111111111111111111111111111111111112"

​
timeframe
enum<string>
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 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
​
include_empty_intervals
boolean
default:false

include empty intervals with no trade data, default: false

Response

200 - application/json

Get OHLCV data of a token

​
data
object
​
meta
object