Skip to main content
GET
Token OHLCV chart

Authorizations

Authorization
string
header
required

An OceanX API key, created in the app under Settings → Developer API. Send it as Authorization: Bearer ox_live_…. These endpoints require the md.read scope, which is on every key by default.

Path Parameters

token
string
required

Base58 Solana mint, or a 0x EVM token address when chain names an EVM chain.

Query Parameters

chain
enum<string>
default:solana

Which chain the token lives on.

Available options:
solana,
ethereum,
base,
bnb,
arbitrum,
polygon,
monad,
hyperevm,
robinhood
resolution
enum<string>
default:1m

Selected candle interval on Solana and EVM. Native EVM candles use the exact requested interval, including sparse seconds, 30m, 2h, 6h, 8h and 12h. Weeks begin Monday UTC; months begin on the first UTC. Empty execution intervals stay empty. EVM native reads are bounded to 90 days; wider requests may return partial history.

Available options:
1s,
5s,
15s,
30s,
1m,
5m,
15m,
30m,
1h,
2h,
4h,
6h,
8h,
12h,
1d,
1w,
1mn
from
integer<int64>

Window start, unix SECONDS (the bars themselves are milliseconds). Defaults to to - limit × resolution.

to
integer<int64>

Window end, unix SECONDS. Defaults to now.

limit
integer
default:500

Maximum bars to return, counted from the end of the window.

Required range: 1 <= x <= 1000
mode
enum<string>
default:price

price returns USD prices; mc returns market cap on the same axis (price × circulating supply). A token with no known supply figure — wrapped SOL, for instance — returns prices under either value.

Available options:
price,
mc
denom
enum<string>
default:usd

Denomination of the OHLC prices. sol divides each bar by the SOL price of its own bucket, and is Solana-only — asking for it on an EVM chain is a 400. Volume (v) stays in USD either way.

Available options:
usd,
sol
pool
string

Restrict bars to one pool address. Solana only. Omit to let the server pick the volume-ranked pool per bucket, which is what the OceanX chart does.

Response

Bars, oldest first.

token
string
required
chain
string
required
Example:

"solana"

resolution
string
required
Example:

"1m"

resolutionSeconds
integer
required

Selected bucket width in seconds, equal to requestedResolutionSeconds on Solana and EVM. Calendar months use a nominal 30-day width here; candle timestamps begin on the first UTC.

from
integer<int64>
required

Window start, unix seconds.

to
integer<int64>
required

Window end, unix seconds.

bars
object[]
required
requestedResolutionSeconds
integer
mode
enum<string>
Available options:
price,
mc
denom
enum<string>
Available options:
usd,
sol
pool
string | null