candles: Get Kline/Candlestick Data

API: kucoin.com:kucoin
Endpoint: /api/v1/market/candles
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 395ms

Description

Returns up to 1500 candlestick records containing open, high, low, close prices and trading volume. Use this for charting, technical analysis, and backtesting trading strategies. Supports intervals from 1 minute to 1 week.

From spec: Get historical candlestick data for a specific symbol

Usage Tips

- Symbol format: BASE-QUOTE (e.g., BTC-USDT) - Valid type values: 1min, 3min, 5min, 15min, 30min, 1hour, 2hour, 4hour, 6hour, 8hour, 12hour, 1day, 1week - Maximum 1500 candles per request - Use startAt/endAt timestamps to paginate historical data

Parameters (4)

endAt (integer, query, optional)

End time in seconds

startAt (integer, query, optional)

Start time in seconds

symbol (string, query, required)

Trading pair symbol (e.g., BTC-USDT)

type (string, query, required)

Candlestick interval

Constraints: {'enum': ['1min', '3min', '5min', '15min', '30min', '1hour', '2hour', '4hour', '6hour', '8hour', '12hour', '1day', '1week']}

Examples (1)

Get 1-hour candlestick data for BTC-USDT doc_extracted

Demonstrates fetching hourly OHLCV candlesticks for Bitcoin against USDT stablecoin

curl 'https://api.kucoin.com/api/v1/market/candles?symbol=BTC-USDT&type=1hour'
import requests

resp = requests.get(
    "https://api.kucoin.com/api/v1/market/candles",
    params={
        'symbol': 'BTC-USDT',
        'type': '1hour',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("kucoin")
result = api.fetch("api/v1/market/candles", symbol="BTC-USDT", type="1hour")

for item in result:
    print(item)
const resp = await fetch("https://api.kucoin.com/api/v1/market/candles?symbol=BTC-USDT&type=1hour");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:31:46.777460 200 395ms
2026-04-16 00:33:31.826164 200 386ms
2026-04-15 03:35:29.174801 200 401ms
2026-04-14 02:59:28.333211 200 375ms
2026-04-12 16:20:24.755376 200 390ms
2026-04-10 02:22:58.123081 200 294ms
2026-04-09 03:50:56.079156 200 354ms