欧易 OKX调用手册
读取现货最新价格与买卖报价
不用 API Key 查询 BTC-USDT 的最新成交价和最优买卖报价。
← 返回平台功能接入准备
- 能按所在地区合法访问相应 OKX API 服务;公共 Market Data 端点不需要私有密钥。
本场景的示例无需设置环境变量;按参数说明替换示例中的资源标识。
调用步骤
- 01
确定产品标识,现货 BTC-USDT 使用连字符;不要套用 Binance 的 BTCUSDT。
- 02
运行一次 GET 查询,只有 code 为字符串 0 才读取 data。
- 03
用 ts 检查数据时间;持续采集应缓存或按官方 WebSocket 设计,而不是无限循环请求。
调用 01
读取单产品 Ticker
下列请求查询现货,不涉及衍生品或交易权限。
GET
https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT请求头
Acceptapplication/json
参数说明
参数表可左右滑动,查看完整说明。
| 字段 / 位置 | 类型 / 必填 | 说明 |
|---|---|---|
instIdQuery | string必填 | 产品 ID,现货示例 BTC-USDT。 |
调用代码
替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
--request GET \
--url "https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT" \
--header "Accept: application/json"
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/ticker?instId=BTC-USDT")
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 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/ticker?instId=BTC-USDT");
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('平台返回业务错误,请结合下方排错说明检查响应');
}
返回示例
按官方结构整理的节选示意,非实测结果。data 数组的 last 为最新成交价,bidPx/askPx 为最优买卖价,ts 为毫秒时间戳;金额保留字符串精度。 以下为结构示意,非本站实测结果。
{
"code": "0",
"msg": "",
"data": [
{
"instType": "SPOT",
"instId": "BTC-USDT",
"last": "60000",
"bidPx": "59999.9",
"askPx": "60000.1",
"ts": "1735689600000"
}
]
}常见错误与排查
code 非 0OKX 返回业务错误- 即使 HTTP 200 也读取 code、msg;检查产品 ID、参数与端点频控后再处理 data。
调用注意
- 限频规则为 IP 维度,文档当前为每 2 秒 20 次;不同请求可能命中独立缓存,不能仅按返回顺序判断快照时间。
注意事项
- 本页只查询,不下单、不划转、不提现。访问域名、账户与产品资格按所属服务地区确认。
- 行情读取无订单成交费用;频控、账户服务与实际交易费用是不同概念,不将公开查询解释为所有服务免费。
核验来源
本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。
- 01OKX API Key 权限与 REST 签名核验日期 2026-10-15
- 02OKX 单产品 Ticker核验日期 2026-10-15
