OKX链上行情API怎么接？代币识别与价格校验

欧易OKX

2026年10月07日

OKX 链上行情 API 的接入门槛不在技术层面，而在计费和鉴权。所有请求都需要签名，免费额度用完后按调用次数付费，付费只支持 X Layer 上的 USDG 或 USDT。代币识别和价格校验的核心问题是：如何用正确的参数拿到正确的代币，以及如何判断你拿到的价格是否可信。

欧易OKX交易所
全球领先的加密货币平台，适合新手与进阶交易者
新手福利：注册即享20% 交易手续费减免！

立即注册 APP下载

接入前的准备工作

你需要先在 OKX Onchain OS 开发者平台创建项目，获取四个凭证：OKX_API_KEY、OKX_SECRET_KEY、OKX_API_PASSPHRASE 和 OKX_PROJECT_ID。每次请求都要在 Header 中携带 OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-PASSPHRASE 和 OK-ACCESS-TIMESTAMP。

签名验证失败是最常见的接入错误。50113 无效的签名 通常意味着查询参数的序列化方式不对，OKX 的签名要求确定性的参数排序。如果你不想手动处理签名，官方提供了 TypeScript SDK（okx-dex-market-sdk），封装了签名逻辑和所有端点。

计费规则：什么时候开始花钱

Market API 采用分级收费。所有 API Key 持有者都有每月免费额度：Basic 等级包含 10 万次免费调用。免费额度用完后，Basic 每次调用收 $0.0001，Premium 收 $0.0002。

付费只支持 X Layer 网络上的 USDG 或 USDT，通过 x402 按次付费模式结算。少数端点完全免费，比如 /api/v6/dex/market/supported/chain 和 /api/v6/dex/balance/supported/chain。

如果你只是做原型验证或低频查询，免费额度通常够用。一旦进入生产环境高频轮询，付费是必然的。

代币识别：地址和链是唯一标识

OKX 链上 API 不靠代币名称或符号来识别代币，链 ID（chainIndex）+ 合约地址（tokenContractAddress） 才是唯一标识。

chainIndex 是 OKX 自己的链标识体系：Ethereum 是 1，Solana 是 501，BSC 是 56。传错链 ID 会返回 50038 不支持的链。

EVM 链的合约地址必须传全小写。如果你从别处复制来的地址包含大写字母，需要先转换，否则请求会失败。

如果你想按名称搜索代币，用 marketTokenSearch 端点，但搜索结果可能返回多个同名的代币，必须靠合约地址确认你要的是哪一个。对于 meme 代币，market/memepump/tokenDetails 端点能返回创建者地址、Top10 持仓占比、Dev 持仓占比、Bundlers 占比等数据，这些是你判断代币风险的关键信息。

价格校验：两个价格来源，用途不同

OKX 提供两个价格来源，用途不同。

Market Price 聚合链上 DEX 交易活动和中心化交易所行情，反映的是代币的"真实市场价格"。它更新快，适合实时监控和交易决策。WebSocket 的 price-info 频道最高每秒推送一次，包含价格、市值、5 分钟到 24 小时的涨跌幅、交易笔数和流动性。普通的 price 频道只在有交易且价格未被 K 线过滤器过滤时才推送。

Index Price 由多个独立第三方来源（CEX、DEX、预言机）计算合成价格，设计目标是抵抗单一来源的价格扭曲。如果你需要抗操纵的参考价——比如设置止损阈值、计算风险参数——用 Index Price 而不是 Market Price。

校验价格是否可信时，检查三个东西：返回的 time 时间戳是否接近当前时间，liquidity 是否足够（低流动性代币的价格容易被操纵），以及 volume24H 是否与价格变动匹配。如果一个小市值代币突然出现大幅价格变动但成交量极低，这个价格大概率不可信。

常见的接入失败

50105 PASSHRASE 不正确：检查 OK-ACCESS-PASSPHRASE 是否与创建 API Key 时设置的一致。

50113 无效的签名：最常见的原因是参数序列化顺序错误。用官方 SDK 可以避免这个问题。

50011 触发限流：试用等级的 RPS 限制通常是 1-5，升级后才能提升。控制请求频率，或实现指数退避重试。

50038 不支持的链：检查 chainIndex 是否正确。不要用链的名称（如 "ethereum"），要用数字标识。

50404 URL not found：确认端点路径拼写正确，v6 版本的端点和 v5 不同。