---
title: "Get historical candles"
method: GET
path: "/v1/markets/{marketId}/candles"
tags: ["Market Data"]
---

# Get historical candles

`GET /v1/markets/{marketId}/candles`

Retrieve historical OHLCV candle data for a market. Limited to 5000 candles per request.

## Path parameters

- `marketId` string, required

## Query parameters

- `interval` '1m' | '5m' | '15m' | '1h' | '4h' | '1d', required
- `from` number, required
- `to` number

## Response `200`

Candle data

- CandlesResponseDto
  - `marketId` string, required
  - `interval` '1m' | '5m' | '15m' | '1h' | '4h' | '1d', required
  - `candles` CandleDto[], required
    - `openTime` number, required — Candle open time (unix milliseconds)
    - `closeTime` number, required — Candle close time (unix milliseconds)
    - `open` string, required
    - `high` string, required
    - `low` string, required
    - `close` string, required
    - `volume` string, required — Volume in base asset units
    - `trades` number, required — Number of trades in this candle

## Other responses

- `400` — Invalid parameters
- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

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