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

# Get Candles

`GET /v1/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/candles`
- Auth: none declared

## Query parameters

- `symbol` string, required: Unified symbol (e.g. btc/usd). Canonical form (BTC-USD) also accepted.
- `exchange` string, nullable: Exchange name (preferred parameter).
- `venue` string, nullable: Legacy alias for exchange.
- `range` '1h' | '1d' | '7d' | '30d' | '180d' | '365d' | 'max': Time range: 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, liquidity, RZ, pump/dump/accu
- `include_footprint` integer: 1 = per-candle per-price volume bins (requires raw_trades)
- `include_fvg` integer: 1 = include backend-computed FVG zones

## 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)