candlesticks: Get candlestick/OHLCV data

API: gateio.ws:gate.io-api
Endpoint: /spot/candlesticks
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 1100ms

Description

Returns historical candlestick (OHLCV) data for a specific trading pair. Use this to visualize price charts, calculate technical indicators, or analyze price trends over time. Each candlestick represents price action for a specific time interval.

From spec: Get historical candlestick (OHLCV) data for a specific trading pair and time interval.

Usage Tips

- Required parameters: currency_pair (e.g., BTC_USDT), interval (e.g., 1h, 15m, 1d) - Optional: limit (default 100, max 1000) to control number of candles returned - Valid intervals: 10s, 1m, 5m, 15m, 30m, 1h, 4h, 8h, 1d, 7d - Rate limit: 300 requests/minute for public endpoints

Parameters (3)

currency_pair (string, query, required)

Trading pair in format BASE_QUOTE (e.g., BTC_USDT)

interval (string, query, required)

Candlestick time interval (e.g., 1m, 5m, 15m, 30m, 1h, 4h, 8h, 1d, 7d, 30d)

Constraints: {'enum': ['1m', '5m', '15m', '30m', '1h', '4h', '8h', '1d', '7d', '30d']}

limit (integer, query, optional, default: 100)

Number of candlesticks to return (default: 100, max: 1000)

Constraints: {'minimum': 1, 'maximum': 1000}

Examples (1)

Get hourly candlesticks for BTC_USDT probe-gate

Demonstrates fetching the last 5 hourly OHLCV candles for Bitcoin/USDT to analyze recent price trends.

curl 'https://api.gateio.ws/api/v4/spot/candlesticks?currency_pair=BTC_USDT&interval=1h&limit=5'
import requests

resp = requests.get(
    "https://api.gateio.ws/api/v4/spot/candlesticks",
    params={
        'currency_pair': 'BTC_USDT',
        'interval': '1h',
        'limit': '5',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("gateio")
result = api.fetch("spot/candlesticks", currency_pair="BTC_USDT", interval="1h", limit=5)

for item in result:
    print(item)
const resp = await fetch("https://api.gateio.ws/api/v4/spot/candlesticks?currency_pair=BTC_USDT&interval=1h&limit=5");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 01:41:44.316596 200 1100ms
2026-04-15 04:00:47.611198 200 1307ms
2026-04-14 03:55:07.796326 200 1430ms
2026-04-12 12:32:10.475664 200 1332ms
2026-04-10 00:10:12.285732 200 1069ms
2026-04-09 03:36:43.524421 200 1284ms
2026-04-08 00:11:24.842789 200 1148ms
2026-04-07 00:12:47.947271 200 2190ms
2026-04-05 22:50:27.493445 200 1707ms