candles: Get candlesticks / OHLCV

API: okx.com:okx-api
Endpoint: /market/candles
Response format: unknown
Auth: unknown
Method: GET
Last Status: 200
Latency: 320ms

Description

Retrieve historical candlestick data (open, high, low, close, volume) for a trading pair.

Parameters (5)

after (string, query, optional)

Timestamp in milliseconds. Return results after this timestamp

bar (string, query, optional, default: 1m)

Time granularity (1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D, 1W, 1M)

Constraints: {'enum': ['1m', '3m', '5m', '15m', '30m', '1H', '2H', '4H', '6H', '12H', '1D', '1W', '1M']}

before (string, query, optional)

Timestamp in milliseconds. Return results before this timestamp

instId (string, query, required)

Instrument ID (e.g., BTC-USDT)

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

Number of results to return (1-300)

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

Examples (2)

Get candlesticks / OHLCV openapi-spec
curl 'https://www.okx.com/api/v5/market/candles?instId=BTC-USDT'
import requests

resp = requests.get(
    "https://www.okx.com/api/v5/market/candles",
    params={
        'instId': 'BTC-USDT',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("okx")
result = api.fetch("market/candles", instId="BTC-USDT")

for item in result:
    print(item)
const resp = await fetch("https://www.okx.com/api/v5/market/candles?instId=BTC-USDT");
const data = await resp.json();
Get candlesticks / OHLCV probe-gate
curl 'https://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1m&limit=100'
import requests

resp = requests.get(
    "https://www.okx.com/api/v5/market/candles",
    params={
        'instId': 'BTC-USDT',
        'bar': '1m',
        'limit': '100',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("okx")
result = api.fetch("market/candles", instId="BTC-USDT", bar="1m", limit=100)

for item in result:
    print(item)
const resp = await fetch("https://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1m&limit=100");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:49:22.735723 200 320ms
2026-04-16 03:07:52.151025 200 324ms
2026-04-15 03:39:18.048081 200 341ms
2026-04-15 00:59:02.027078 200 335ms
2026-04-14 02:32:36.188015 200 325ms
2026-04-14 00:51:48.966156 200 325ms
2026-04-12 15:20:21.443772 200 321ms
2026-04-12 14:43:51.003974 200 305ms
2026-04-10 05:10:10.150831 200 521ms
2026-04-10 01:48:01.257104 200 566ms
2026-04-09 02:57:39.563146 200 452ms
2026-04-09 00:44:12.409497 200 339ms
2026-04-03T10:19:27.513285 200 266ms