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)
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();