---
title: "Get candlestick (OHLC) data"
method: GET
path: "/api/v1/candlesticks"
tags: ["Market Data"]
---

# Get candlestick (OHLC) data

`GET /api/v1/candlesticks`

Retrieve candlestick data for a specific market and time range.
Supports intervals: 1m, 15m, 1h, 4h, 1d. Missing intervals are interpolated using the last known close price.
Maximum 1000 candles per request.

Optionally set `filterWicks=true` to suppress extreme H/L wicks caused by liquidation
cascades or low-liquidity outlier fills. The filter computes a cross-candle
volume-weighted typical price and standard deviation, then clamps each candle's
high and low to `[VWAP ± nSigma × σ_v]` without touching open or close.

## Query parameters

- `market` string, required
- `interval` '1m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1mo', required
- `startTime` integer, required
- `endTime` integer, required
- `filterWicks` boolean
- `nSigma` number, double

## Response `200`

Candlestick data retrieved successfully

- CandlestickResponseItemDto[]
  - `T` integer, required
  - `c` number, double, required
  - `h` number, double, required
  - `i` string, required
  - `l` number, double, required
  - `o` number, double, required
  - `t` integer, required
  - `v` number, double, required

## Other responses

- `400` — Invalid parameters (e.g., start_time > end_time or exceeds max candles)
- `404` — Market not found
- `500` — Database error

---

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