欧易 OKX调用手册

读取并解释现货 K线

读取最近 10 根 1 小时 K线,区分未完成和已收盘数据。

官方资料核对 2026-10-15示例代码,未进行真实接口实测
← 返回平台功能

接入准备

  • 公共 Market Data 查询,无需 API Key。

本场景的示例无需设置环境变量;按参数说明替换示例中的资源标识。

调用步骤

  1. 01

    设置 instId=BTC-USDT、bar=1H、limit=10,周期大小写按文档填写。

  2. 02

    读取 data 数组,按每行的固定字段位置解释数值。

  3. 03

    如需要向历史翻页,取最旧一行的 ts,作为下一次 after;绘图前按 ts 升序整理并去重。

调用 01

读取最新 K线

bar=1H 为小时线。这里只取 10 根,避免默认返回更多数据。

GEThttps://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1H&limit=10

请求头

Accept
application/json

参数说明

参数表可左右滑动,查看完整说明。

字段 / 位置类型 / 必填说明
instIdQuerystring必填现货产品 ID,例如 BTC-USDT。
barQuerystring可选默认 1m;示例 1H。日线还区分 UTC+8 的 1D 与 UTC+0 的 1Dutc。
limitQuerystring/integer可选默认 100,最大 300;示例 10。
afterQuerystring可选向更早历史翻页的毫秒时间戳;与常见 after=更新数据的语义相反。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。

cURL
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request GET \
  --url "https://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1H&limit=10" \
  --header "Accept: application/json"
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1H&limit=10")
headers = {
    "Accept": expand("application/json"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "code" in result and result["code"] != "0":
    raise SystemExit("平台返回业务错误,请结合下方排错说明检查响应")
Node.js
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://www.okx.com/api/v5/market/candles?instId=BTC-USDT&bar=1H&limit=10");
const headers = Object.fromEntries(
  Object.entries({
  "Accept": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "code") && result["code"] !== "0") {
  throw new Error('平台返回业务错误,请结合下方排错说明检查响应');
}

返回示例

按官方结构整理的节选示意,非实测结果。每行依次为 [ts,o,h,l,c,vol,volCcy,volCcyQuote,confirm];confirm=0 未收盘,1 已收盘。现货 vol 为基础币数量,volCcy/volCcyQuote 为报价币成交量。 以下为结构示意,非本站实测结果。

JSON
{
  "code": "0",
  "msg": "",
  "data": [
    [
      "1735689600000",
      "60000",
      "60200",
      "59800",
      "60100",
      "12",
      "720000",
      "720000",
      "1"
    ]
  ]
}

常见错误与排查

code 非 0OKX 返回业务错误
即使 HTTP 200 也读取 code、msg;检查产品 ID、参数与端点频控后再处理 data。

调用注意

  • 此端点仅覆盖最近 1440 条数据;更早历史使用 history-candles 并另核对范围。
  • 最新一根可能未收盘;回测或已收盘指标应剔除 confirm=0 的行。文档频控为 IP 每 2 秒 40 次。

注意事项

  • 本页只查询,不下单、不划转、不提现。访问域名、账户与产品资格按所属服务地区确认。
  • 行情读取无订单成交费用;频控、账户服务与实际交易费用是不同概念,不将公开查询解释为所有服务免费。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
    OKX API Key 权限与 REST 签名核验日期 2026-10-15
  2. 02
    OKX 最新 K线参数核验日期 2026-10-15

欧易 OKX的其他调用手册

← 返回欧易 OKX的全部功能