OKX API错误码在哪查?KYC与权限文档入口

 / 
8

在 OKX,API 错误码、KYC 权限要求、签名规则等,全部统一收录在官方 API 文档里。不存在专门仅用于查询错误码的独立页面,错误码是跟具体接口和场景放在一起说明的。同时,KYC 状态和 API 权限也在同一个「API 管理」页面里查看。

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

步骤 1:查 API 错误码——去官方 API 文档搜

只要你调用接口后返回了错误代码,直接去 OKX 官方的 API 文档里查对应的含义。

  • 做什么:打开 OKX 官方 API 文档的错误码章节。

  • 怎么做:访问 OKX 官网 → 顶部菜单【API】→ 进入 API 文档中心,在导航栏中找到「Error Codes」或「错误码」章节。文档按 API 类型(REST、WebSocket、Web3 等)和业务模块分类列出了常见错误码。

  • 常见错误码举例

    • 50101:API Key 和环境不匹配(实盘 Key 调了模拟盘,或模拟盘 Key 调了实盘)。

    • 50119:API Key 不存在或区域域名不匹配(EEA 用户需用 eea.okx.com 域名)。

    • 50120:API Key 缺少交易权限,或账户未完成衍生品 KYC 认证。

    • 50011:触发频率限制(Rate Limit)。

    • 50103-50113:请求头签名错误(OK-ACCESS-KEY、OK-ACCESS-SIGN 等缺失或无效)。

  • 完成标准:找到你收到的错误码,并阅读对应的解决方案。

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

步骤 2:查 KYC 是否影响 API——去「API 管理」页面看权限

KYC 状态不在错误码文档里查,而是和 API 密钥的权限设置绑定的。

  • 做什么:在 OKX 账户的「API 管理」页面,查看当前 API Key 的权限,同时确认账户是否已完成对应产品的 KYC。

  • 怎么做

    1. 查 API 权限:登录 OKX → 点击右上角头像 → API → 选择要查看的 API Key,检查「Read(读取)」、「Trade(交易)」、「Withdraw(提现)」权限是否勾选。

    2. 查 KYC 状态:API 权限本身不显示 KYC 等级,但如果你尝试调用合约或衍生品接口时收到 50120 错误,说明账户未完成衍生品 KYC 认证,或该地区衍生品交易被限制。

    3. API 协议明确要求:使用 API 服务前,用户必须按 API 访问要求的级别完成 KYC 和 AML 验证程序。

  • 完成标准:确认 API Key 已勾选所需权限,且账户 KYC 等级满足目标交易产品的合规要求。

常见失败原因:很多人以为创建了 API Key 就能直接用,忽略了 KYC 未完成或权限没勾全是导致调用失败最常见的原因。衍生品交易相关的接口,对 KYC 要求通常比现货更严格。

操作完成的校验方式:在 API 管理页面确认权限状态后,用官方文档里提供的示例代码(如 Python SDK)发一个只读请求(比如查询账户余额)。如果能正常返回数据,说明权限和 KYC 都没问题。如果返回错误码,按步骤 1 去文档里查具体含义。