---
title: "Candles"
method: GET
path: "/v1/chart/candles"
tags: ["chart"]
---

# Candles

`GET /v1/chart/candles`

## Request

- Base URL: `https://app.mrtrades.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.mrtrades.com/v1/chart/candles`
- Auth: none declared

Compact candle series for charting.

Returns parallel arrays: t (epoch ms), o, h, l, c, v. Optionally bv/sv, footprint_bins, overlays.
Server-side buckets to keep ≤ max_points. Use with GET or WebSocket (live, tier≥1).

## Query parameters

- `symbol` string, required: Asset symbol (e.g. BTC, ETH)
- `venue` string, nullable: Exchange (e.g. hyperliquid). Omit to use Hyperliquid when that coin is listed there. Use 'all' to aggregate hyperliquid, binance, bybit (combined OHLCV / footprint / DOM).
- `range` '1h' | '1d' | '7d' | '30d' | '180d' | '365d' | 'max': Time range: 1h, 1d, 7d, 30d, 180d, 365d, max
- `max_points` integer: Max candle count (server buckets to fit)
- `tf` '5s' | '30s' | '1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '12h', nullable: Timeframe: 5s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 12h. Auto if omitted.
- `include_overlay` integer: 1 = ST lines, ATR bands, ATR cloud, liquidity, RZ, pump/dump/accu
- `include_footprint` integer: 1 = per-candle per-price volume bins (requires raw_trades)
- `footprint_bars` integer: Only attach bins for the newest N candles (0 = all bars in the window). Live WS should pass a small N.
- `end_ms` integer, nullable: Optional window end (epoch ms). When set, range lookback ends here instead of now — used for scroll-left history.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mrtrades/apis/mtdp-api.md) · [All operations](https://skmtc.dev/mrtrades/apis/mtdp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mrtrades/apis/mtdp-api/revisions/bc6c76f51439?raw)