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"
    }
  }
}

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.
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:

[
  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

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

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

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

response = client.onchain.networks.tokens.ohlcv.get_timeframe(
  "day",
  network="solana",
  token_address="So11111111111111111111111111111111111111112",
)

print(response.model_dump_json(indent=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 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

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

Hide child attributes

data.id

string

required

Request ID

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.ohlcv_list

number[][]

required

OHLCV data as [timestamp, open, high, low, close, volume] arrays

CoinGecko API

Onchain API

Token OHLCV Chart by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response