OKX API 教学:创建密钥、设置权限,接上自动交易

从创建 API 密钥、选权限、设 IP 白名单,到下单被拒时每个错误代码代表什么、该怎么处理。

最后更新 2026-11
披露:本文的 OKX 注册链接是 Blave 的合作链接,通过它注册,Blave 可能获得返佣。

还没有 OKX 账户?注册 OKX

要点总结
  • OKX API 密钥由三样东西组成:API Key、Secret Key、Passphrase。Passphrase 是你自己设的,忘了只能删掉重建。
  • 自动交易只要开「读取」和「交易」权限,「提币」一律不开。
  • 有交易权限、没绑 IP 的密钥,14 天没有动作会被 OKX 自动删除。
  • 下单回 50004 或 51149 超时,不代表没成交,要先查订单,不要直接重送。

OKX API 是什么?

OKX API 是让程序直接跟 OKX 账户沟通的界面:查余额、查持仓、下单、撤单,都不用开网页。自动交易程序就是通过 API 照规则下单。

用 API 要先创建一把密钥,程序拿这把密钥证明「我是这个账户授权的」。密钥能做什么,取决于创建时开了哪些权限。

怎么创建 OKX API 密钥?

注册 OKX 账户
提币权限一律不开。自动交易只需要读取和交易。就算密钥外泄,没有提币权限也搬不走你的币。
  1. 登录 OKX 网页版,到「个人资料 → API 和连接」,按「创建 API key」。
  2. 填 API key 名称,选择账户和用途。
  3. 设置 IP 白名单(见下一节)。
  4. 权限勾「读取」和「交易」,「提币」不要勾。
  5. 设置 Passphrase 并记下来。OKX 创建后不会再显示。
  6. 完成安全验证,记下 API Key 和 Secret Key,放在安全的地方。

三样东西一起交给自动交易程序,缺一样都连不上。

IP 白名单要不要设?

OKX 官方 API FAQ 写明:有交易或提币权限、没绑 IP 的密钥,14 天没有动作就会被自动删除。绑了 IP,密钥不会因为闲置而过期,别人拿到密钥也没办法从其他地方用。一把密钥最多绑 20 个 IP。

要绑的话,填的是「跑程序那台机器」的对外 IP,不是你手机或平常上网的 IP。家里的网络 IP 可能会变,变了就要把新 IP 加进白名单。

用 Blave Agent 的话:云端主机的连接框会显示主机 IP,照填就好。电脑版不要求绑,不绑就要记得 14 天规则。

OKX API 常见错误代码

下面是自动交易最常遇到的错误。说明照 OKX 官方 API 文档(51008 照 Blave 下单程序的分类),处理方式是一般建议。

代码意思怎么处理
第一类:密钥和权限的问题,连接或下单时就会被拒
50111API Key 无效检查有没有贴错、前后有没有多空白
50113签名无效通常是 Secret Key 贴错,重贴一次
50105Passphrase 不对填创建密钥时自己设的那组,不是登录密码
50110IP 不在白名单把跑程序那台机器的新 IP 加进白名单
50119密钥不存在可能被删了(例如 14 天规则),重建一把
50100API 被冻结联系 OKX 客服
第二类:密钥没问题,但这张单本身送不出去
51010目前的账户模式不支持现货模式不能做合约,到账户模式设置改成能做合约的模式
51008保证金不足补资金,或调低策略金额
51020低于最小下单量调高策略金额,或换最小单位比较小的币
50102请求时间戳过期跑程序那台机器的时钟不准,打开自动对时
第三类:结果不确定,最要小心
50004API 请求超时不要重送,先查订单
51149下单超时不要重送,先查订单
50001服务暂时无法使用不要重送,先查订单
50026系统错误不要重送,先查订单

OKX 文档明写 50004 和 51149「不代表请求成功或失败」。单可能已经成交了,直接重送就会变成下两次。Blave Agent 遇到这四个代码,一律不重送同一张单:合约市价单会回头查这张单有没有成交,再决定下一步。其他单会停下来回报,不会自动重试。

自己写程序接 OKX API 的话,这一点最容易出事。

用 Blave Agent 接 OKX,不用自己处理这些

上面的错误处理,包括遇到 50102 自动跟 OKX 对时、超时不重送,Blave Agent 的下单程序都做好了。你只要把 API Key、Secret Key 和 Passphrase 贴进「自动下单 › 连接账户 › OKX」,策略就能照规则在 OKX 下单。

接真账户之前,建议先用模拟交易跑一段时间,不用密钥,起始 100,000 USDT。

下载电脑版

完整步骤见〈设定交易所下单密钥〉。从找想法到上线的整个流程见〈OKX 自动交易:从找想法、回测到上线〉。

常见问题

API 密钥会过期吗?
有绑 IP 的不会因为闲置过期。有交易或提币权限、没绑 IP 的,14 天没有动作会被删除。

Passphrase 忘了怎么办?
没办法找回,只能删掉这把密钥、重建一把,再把新的三样东西贴回程序。

每天什么时候最容易下单超时?
OKX 建议避开每天 8 点、16 点、24 点(台湾时间),那是资金费结算时间,服务器压力最大。

风险先讲

API 密钥等于账户的交易授权,不要贴到不信任的网站或程序。提币权限一律不开,用不到的密钥就删掉。自动交易不会让亏损消失,只是照规则运行。用杠杆时,亏损会跟着放大。