从创建 API 密钥、选权限、设 IP 白名单,到下单被拒时每个错误代码代表什么、该怎么处理。
还没有 OKX 账户?注册 OKX
OKX API 是让程序直接跟 OKX 账户沟通的界面:查余额、查持仓、下单、撤单,都不用开网页。自动交易程序就是通过 API 照规则下单。
用 API 要先创建一把密钥,程序拿这把密钥证明「我是这个账户授权的」。密钥能做什么,取决于创建时开了哪些权限。
三样东西一起交给自动交易程序,缺一样都连不上。
OKX 官方 API FAQ 写明:有交易或提币权限、没绑 IP 的密钥,14 天没有动作就会被自动删除。绑了 IP,密钥不会因为闲置而过期,别人拿到密钥也没办法从其他地方用。一把密钥最多绑 20 个 IP。
要绑的话,填的是「跑程序那台机器」的对外 IP,不是你手机或平常上网的 IP。家里的网络 IP 可能会变,变了就要把新 IP 加进白名单。
用 Blave Agent 的话:云端主机的连接框会显示主机 IP,照填就好。电脑版不要求绑,不绑就要记得 14 天规则。
下面是自动交易最常遇到的错误。说明照 OKX 官方 API 文档(51008 照 Blave 下单程序的分类),处理方式是一般建议。
| 代码 | 意思 | 怎么处理 |
|---|---|---|
| 第一类:密钥和权限的问题,连接或下单时就会被拒 | ||
| 50111 | API Key 无效 | 检查有没有贴错、前后有没有多空白 |
| 50113 | 签名无效 | 通常是 Secret Key 贴错,重贴一次 |
| 50105 | Passphrase 不对 | 填创建密钥时自己设的那组,不是登录密码 |
| 50110 | IP 不在白名单 | 把跑程序那台机器的新 IP 加进白名单 |
| 50119 | 密钥不存在 | 可能被删了(例如 14 天规则),重建一把 |
| 50100 | API 被冻结 | 联系 OKX 客服 |
| 第二类:密钥没问题,但这张单本身送不出去 | ||
| 51010 | 目前的账户模式不支持 | 现货模式不能做合约,到账户模式设置改成能做合约的模式 |
| 51008 | 保证金不足 | 补资金,或调低策略金额 |
| 51020 | 低于最小下单量 | 调高策略金额,或换最小单位比较小的币 |
| 50102 | 请求时间戳过期 | 跑程序那台机器的时钟不准,打开自动对时 |
| 第三类:结果不确定,最要小心 | ||
| 50004 | API 请求超时 | 不要重送,先查订单 |
| 51149 | 下单超时 | 不要重送,先查订单 |
| 50001 | 服务暂时无法使用 | 不要重送,先查订单 |
| 50026 | 系统错误 | 不要重送,先查订单 |
OKX 文档明写 50004 和 51149「不代表请求成功或失败」。单可能已经成交了,直接重送就会变成下两次。Blave Agent 遇到这四个代码,一律不重送同一张单:合约市价单会回头查这张单有没有成交,再决定下一步。其他单会停下来回报,不会自动重试。
自己写程序接 OKX API 的话,这一点最容易出事。
上面的错误处理,包括遇到 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 密钥等于账户的交易授权,不要贴到不信任的网站或程序。提币权限一律不开,用不到的密钥就删掉。自动交易不会让亏损消失,只是照规则运行。用杠杆时,亏损会跟着放大。