---
title: "Get jetton OHLCV candlestick data"
method: GET
path: "/api/v3/jettons/{address}/ohlcv-chart"
tags: ["Jettons"]
---

# Get jetton OHLCV candlestick data

`GET /api/v3/jettons/{address}/ohlcv-chart`

Returns up to `limit` most recent non-empty OHLC candles of the requested
`interval` grain. Window is automatically widened: provider over-fetches,
filters empty candles (zero volume and flat OHLC), retries once if not
enough candles collected. Returns fewer than `limit` only if data is
genuinely scarce.

Pass `from` to pin the window instead: then only candles inside
[from, before) come back and the period is predictable.

## Path parameters

- `address` string, required

## Query parameters

- `interval` '1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '6h' | '12h' | '1d' | '24h' | '1w' | '7d', required
- `limit` integer
- `before` string, date-time
- `from` string, date-time
- `currency` 'usd' | 'ton'
- `autoInterval` boolean

## Response `200`

OHLCV data

- ApiJettonOhlcvResponse
  - `candles` ApiJettonOhlcvCandle[], required — Array of OHLC candles sorted by time ascending
    - `time` string, date-time, required — Candle start time (ISO 8601)
    - `open` number, double, required
    - `high` number, double, required
    - `low` number, double, required
    - `close` number, double, required
    - `volume` number, double, nullable — Trading volume (may be absent for some providers like DYOR)
  - `interval` string — Grain the candles are actually in. Equals the requested `interval` unless `autoInterval` coarsened it. Label charts with this, not with what was asked for.

## Other responses

- `400` — Invalid interval/currency or no OHLCV data available for jetton
- `default` — Some error during request processing

---

[API](https://skmtc.net/swap/apis/tokens-service.md) · [All operations](https://skmtc.net/swap/apis/tokens-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swap/tokens-service/revisions/b8fd8c19faee/schema)