为了帮助用户更好地理解和使用 OKX API，本文汇总了多个常见问题及其解决方案，涵盖 APIKey 管理、交易接口调用、错误码处理等核心内容。无论您是开发者还是交易者，都能在这里找到实用的操作指南和故障排除建议。
APIKey 管理
什么是 Passphrase？
Passphrase 是您在申请 APIKey 时填写的密码，需自行妥善保管。一旦遗忘，无法找回，必须重新创建新的 APIKey。
如何创建模拟盘 APIKey？
要在模拟盘上进行交易，需先创建模拟盘 APIKey。具体步骤如下：
- 登录 OKX 账户
- 进入“交易” > “模拟交易” > “个人中心”
- 选择“创建模拟账户 APIKey”
- 开始模拟交易
APIKey 会过期吗？
- 未绑定 IP 且具备交易或提现权限的 APIKey，若连续 14 天未使用，将被自动删除。
- 如果 APIKey 用于调用需身份验证的私有接口（如查询余额、账单数据或下单），则不会被判定为闲置。
- 仅绑定 IP 或具有只读权限的 APIKey 不会过期。
交易接口操作
下单时能否以 USDT 或其他货币为单位？
合约订单接口默认以合约张数为单位。如需计算张数与币数量的转换，可参考张数币数量转换接口。
如何获取涨跌幅数据？
接口无法直接获取涨跌幅，但可通过公式计算：
（最新成交价 - 24 小时前 K 线开盘价）/ 24 小时前 K 线开盘价 × 100%
相关数据可通过行情接口获取，公式为：(last - open24h) / open24h。
下单报错“51000 Parameter posSide error”怎么办？
首先检查账户模式：
- 若为买卖模式或开平模式，可通过接口获取
posMode参数。 注意：
- 开平模式下使用合约下单时，必须填写
posSide参数（long 或 short）。 - 买卖模式，或开平模式下的币币、杠杆交易，
posSide仅支持 net 或不传。
- 开平模式下使用合约下单时，必须填写
如何获取合约面值和最小下单量？
可通过交易产品基础信息接口查询：
- 合约面值字段：
ctVal - 最小下单量字段：
minSz
instId 的格式是什么？
instId 格式因产品类型而异，可通过产品信息接口查询。示例：
- 币币/币币杠杆：
BTC-USDT - 永续合约：币本位为
BTC-USD-SWAP，U 本位为BTC-USDT-SWAP（全部大写） - 交割合约：币本位如
BTC-USD-210326，U 本位如BTC-USDT-210326（后缀为日期标识） - 期权合约：看涨期权如
BTC-USD-210326-2000-C，看跌期权如BTC-USD-210326-2000-P
如何设置止盈止损？
- 附带给单止盈止损：可在下单时通过
attachAlgoOrds数组参数设置。 - 独立止盈止损单：需参考策略委托接口下单。
设置止盈止损触发价报错（51046–51049）的原因？
触发价设置需符合规则：
- 卖出时：止盈触发价 > 最新价，止损触发价 < 最新价
- 买入时：止盈触发价 < 最新价，止损触发价 > 最新价
常见接口错误与解决方案
“50102 Timestamp request expired” 时间戳过期
此错误源于本地时间与服务器时间不同步。解决方法：
- 调用系统时间接口同步时间
- 确保时间差在 30 秒内
- 注意：请求头时间为 UTC0，而服务器时间接口返回 UTC+8 时间
“50101 APIKey does not match the current environment” 环境不匹配
- 实盘账户调用：需使用实盘 APIKey，且请求头
x-simulated-trading参数为 0 - 模拟账户调用：需使用模拟盘 APIKey，且
x-simulated-trading参数为 1
“51010 Request unsupported under current account mode” 账户模式不支持
进行币币杠杆或合约交易时，账户模式需调整为“非现货模式”。设置方式：
- 通过接口调整账户模式
- 在网页或 APP 端设置：交易主页菜单 - 账户模式
- 注意：首次设置必须在页面或 APP 端完成
“51121 Order quantity must be a multiple of the lot size” 数量非最小倍数
合约下单张数必须是该币对最小下单量的整数倍。最小下单量可通过产品接口的 minSz 字段获取。
提现错误“58207 Withdrawal address is not whitelisted”
即使页面关闭了白名单验证，API 提现仍需：
- 在页面添加提现地址
- 勾选“免验证”按钮
- 页面白名单设置不影响接口功能
“50004 API endpoint request timeout” 请求超时
该错误通常由服务器压力过大引起：
- 每天 8:00、16:00、24:00（UTC+8）为资金费率结算时段，建议避开此时段交易
- 其他时段报错可稍后重试
- 注意：50004 错误不代表最终请求结果，需以实际查询为准
常见问题
如何同步服务器时间？
调用系统时间接口，校准本地时间与服务器时间差在 30 秒内即可。
模拟盘与实盘 APIKey 能否混用？
不能。模拟盘和实盘环境完全隔离，APIKey 和请求头参数必须严格对应。
最小下单量在哪里查询？
通过产品基础信息接口的 minSz 字段获取，或交易页面查看币对详情。
止盈止损触发价设置有何限制？
必须符合当前买卖方向的价格逻辑，且需基于最新成交价计算。
接口报错时如何快速定位？
首先根据错误码对照文档排查，常见问题包括时间戳、账户模式、参数格式等。
API 提现是否需要验证地址？
即使关闭白名单验证，仍需在页面添加地址并勾选免验证选项。
通过以上指南，您可以更高效地使用 OKX API 进行交易和管理。如遇其他问题，建议参考官方文档或联系技术支持。