Token Candles

get

https://api.vybenetwork.xyz/v4/tokens/{mintAddress}/candles

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Replaces: GET price/{mintAddress}/token-ohlcv

Retrieve Open, High, Low, and Close (OHLC) for a token’s USD price based on aggregated trades for all USDC/USDT/PYUSD/WSOL markets.

Path Params

mintAddress

string

required

The public key of the token of interest

Query Params

resolution

string | null

enum

Resolution of the data. Possible values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 3h, 4h, 1d, 1w, 1mo, 1y. Default is "1h".

timeStart

int64 | null

≥ 0

Start time of the data to return (unix timestamp)

timeEnd

int64 | null

≥ 0

End time of the data to return (unix timestamp)

limit

int32 | null

≥ 0

Result page size specifier. Default is 1000.

page

int32 | null

≥ 0

Page number for paginated results

eliminateCloseToOpenGaps

boolean

Eliminate gaps between candles by using previous close as next open. Default is true.

fillEmptyCandles

boolean

Emit a synthetic candle for every bucket in the requested time window, even when no trades occurred. When true, empty buckets are filled with the previous close as open/high/low/close and volume/count of 0. When false (default), only buckets that contain real trades are returned.

countBack

int32 | null

≥ 0

Return the last N real (stored) candles ending at timeEnd (defaults to now), in ascending order. This is the TradingView getBars(countBack, to) pattern: request exactly the bars the chart needs in one shot instead of guessing a time window. When set, countBack takes precedence and timeStart, limit, page, and fillEmptyCandles are ignored. Capped at 1000 (values above are clamped, not rejected). If the token has fewer than N candles, all available candles are returned. eliminateCloseToOpenGaps still applies. When omitted, the endpoint behaves exactly as before.

Responses

200Tokens info collected

400Invalid parameters — verify time range, filters, and pagination inputs.

500Internal server error