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

Bucket width. Sub-minute resolutions are Solana-only in practice — no EVM data vendor publishes them, so an EVM request is served at the nearest FINER supported bucket and resolutionSeconds tells you which.

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

Bucket width actually served. Equals requestedResolutionSeconds on Solana; larger on an EVM chain whose vendor cannot serve the requested width.

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