Skip to main content
GET
/
onchain
/
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": "2dea0d2f-bf0f-4fa6-a934-db61d9375dbe",
    "type": "ohlcv_request_response",
    "attributes": {
      "ohlcv_list": [
        [
          1779926400,
          82.26780088646034,
          83.8971583220568,
          79.9616,
          80.4112417847994,
          31314919.221351475
        ],
        [
          1779840000,
          83.65257586508716,
          84.8896434634975,
          81.99,
          82.26780088646034,
          118334565.59596911
        ]
      ]
    }
  },
  "meta": {
    "base": {
      "name": "Wrapped SOL",
      "symbol": "SOL",
      "coingecko_coin_id": "wrapped-solana",
      "address": "So11111111111111111111111111111111111111112"
    },
    "quote": {
      "name": "USD Coin",
      "symbol": "USDC",
      "coingecko_coin_id": "usd-coin",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    }
  }
}

​
Notes

  • Returns OHLCV data from the most liquid pool of the token. Use Top Pools by Token Address to check which pool is used.
  • Timestamps use epoch/unix format (e.g. 1708850449).
  • Analyst plan and above can access data from September 2021 to present (depending on pool tracking start). Each call retrieves a max 6-month range — use before_timestamp for older data.
  • Each ohlcv_list element: 
    [
  timestamp,
  open,
  high,
  low,
  close,
  volume
]
  • Intervals with no swaps are skipped by default. Set include_empty_intervals=true to fill gaps (OHLC = previous close, volume = 0).

​
SDK Examples

const response = await client.onchain.networks.tokens.ohlcv.getTimeframe('day', {
  network: 'solana',
  token_address: 'So11111111111111111111111111111111111111112',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

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

Learn how to set up your API key

Path Parameters

​
network
string
default:solana
required

Network ID. *refers to /onchain/networks.

​
token_address
string
default:So11111111111111111111111111111111111111112
required

Token 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 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: usd

Available options:
usd,
token
​
include_empty_intervals
boolean

Include empty intervals with no trade data. Default: false

​
include_inactive_source
boolean

Include token data from inactive pools using the most recent swap. Default: false

Response

200 - application/json

Token OHLCV chart data

​
data
object
required
​
meta
object
required