Skip to main content
GET
Get OHLCV data for a token.

Endpoint overview

One candle series per token, in USD. Where pool OHLCV gives you the price of one pair in one pool, this endpoint gives you the token’s price across every pool it trades in on the network, weighted by volume. You do not have to pick a pool first, and a thin pool with a stray trade does not become your chart. The candles come from the same token price series as the real-time OHLCV stream, so you can load history here and continue live on /sse/ohlcv.
Dev, Pro or Enterprise only. Keyless requests and free keys get 403 with {"message":"this endpoint requires a Dev or Pro plan"}. Paid plans call https://api-pro.dexpaprika.com with the key as the whole Authorization header. Get a key in console.dexpaprika.com and compare plans on pricing.

Plan limits

start, end and the number of candles are checked against the window the same way as on pool OHLCV. Details on the rate limits page. Each request costs one credit, whatever the number of candles it returns.

Reading the response

  • open, high, low and close are USD prices. There is no inversed flag here, because a token series has no second token to flip to.
  • volume is the USD value traded in the token across all its pools during the candle, as a whole number.
  • A candle only exists for an interval in which the token traded. On a quiet token a series of 1m candles has gaps; fill them on your side if your chart needs a continuous axis.
  • The latest candle can still be open. Its time_close is then earlier than a full interval after time_open, and its values change until the interval ends. Re-read it rather than caching it.

FAQs

Pool OHLCV is the price of one pair in one pool, quoted in the other token of that pair unless you flip it with inversed. Token OHLCV is the token’s USD price across every pool it trades in on the network, weighted by volume, with volume summed across those pools. Use token OHLCV for charts, backtests and valuation; use pool OHLCV when you care about one specific market.
Dev, Pro and Enterprise, on https://api-pro.dexpaprika.com. Dev can query the last 30 days; Pro and Enterprise have no plan limit on history. Keyless requests and free keys get 403. Plans are on pricing.
1m, 5m, 10m, 15m, 30m, 1h, 6h, 12h, 24h, up to 1000 candles per request. interval defaults to 24h and limit to 10, so set both.
start is required: a relative offset from now (-24h, -7d, -90m), an RFC3339 timestamp, a date or Unix seconds. end is optional and takes the same formats. On Dev the range must fit inside the last 30 days.
A candle is only produced for an interval in which the token traded. No trades, no candle. This is expected on less active tokens and on short intervals.

Path Parameters

network
string
required

Network slug or ID (e.g., 'solana'). You can find the list of supported networks with their IDs here: /networks.

token_address
string
required

Token contract address. Such as JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN for Jupiter on Solana.

Query Parameters

start
string
required

Start time for the OHLCV data. Required; "-24h" selects the last 24 hours. Accepted formats:

  • Relative offset from now (e.g., "-24h", "-7d", "-90m"; units: s, m, h, d)
  • Unix timestamp
  • RFC3339 timestamp (e.g., "2023-10-27T08:07:20Z")
  • Date (e.g., "2023-10-27", interpreted as 00:00:00 UTC)
Example:

"-24h"

end
string

End time for the OHLCV data. Accepted formats:

  • Relative offset from now (e.g., "-1h", "-2d")
  • Unix timestamp
  • RFC3339 timestamp (e.g., "2023-10-27T10:00:00Z")
  • Date (e.g., "2023-10-27", interpreted as 00:00:00 UTC)
Example:

"1741508640"

limit
integer<int32>
default:10

Maximum number of OHLCV records to return.

Required range: 1 <= x <= 1000
interval
enum<string>
default:24h

The time interval for each OHLCV record (candle).

Available options:
1m,
5m,
10m,
15m,
30m,
1h,
6h,
12h,
24h
count_back
integer<int32>

Returns the last N candles with data up to end, ignoring start.

Required range: 0 <= x <= 350

Response

A list of OHLCV records successfully retrieved.

time_open
string<date-time>
required

The opening timestamp of the OHLCV period.

Example:

"2023-10-27T10:00:00Z"

time_close
string<date-time>
required

The closing timestamp of the OHLCV period.

Example:

"2023-10-27T11:00:00Z"

open
number<double>
required

The opening price for the period.

Example:

1500.5

high
number<double>
required

The highest price reached during the period.

Example:

1525.75

low
number<double>
required

The lowest price reached during the period.

Example:

1495.25

close
number<double>
required

The closing price for the period.

Example:

1510

volume
integer<int64>
required

The total volume traded during the period.

Example:

1234567890123