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

# Get Candles

`GET /v1/candles`

## Request

- Base URL: `https://api.candlefeed.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.candlefeed.ai/v1/candles`
- Auth: API key in header `X-API-Key`

Get historical OHLCV candle data.

Returns time series of open, high, low, close, volume for the requested symbol.
Supports server-side resampling: 1m, 5m, 15m, 1h, 4h, 1d.

## Query parameters

- `symbol` string, required: Trading pair symbol (e.g., BTCUSDT)
- `exchange` string: Exchange name
- `interval` string: Candle interval (1m, 5m, 15m, 1h, 4h, 1d)
- `start` string, nullable: Start time (ISO 8601)
- `end` string, nullable: End time (ISO 8601)
- `limit` integer, nullable: Max rows to return
- `cursor` string, nullable: Pagination cursor (timestamp)
- `format` 'json' | 'csv': Response format

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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