API 常见问答
一、请问 Passphrase 指的是什么呢？
Passphrase 是您申请 APIKey 时填写的密码，需要您自行记住，一旦忘记无法找回，只能重新创建 APIKey 。
二、请问如何创建模拟盘 APIKey ？
模拟盘 API 交易需要在模拟盘上创建 APIKey ：
登录欧易账户 —> 交易 —> 模拟交易 —> 个人中心 —> 创建模拟盘 APIKey —> 开始模拟交易
三、APIKey 会过期吗？
1、实盘未绑定 IP 且拥有交易或提币权限的 APIKey ，将在闲置 14 天之后自动删除，只有调用私有类或账户类需要身份验证的接口才不算是闲置，比如查看账户余额、账单数据、下单操作等。
2、绑定了 IP 或权限只有只读的 APIKey 不会过期。
四、接口下单合约能否以 USDT 或者币为单位下单？
不可以；合约下单，接口默认是以张为单位下单的；如果您需要计算张币转换，可以参考张币转换接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-unit-convert
五、接口如何获取涨跌幅？
接口无法直接获取到涨跌幅，但是可以通过计算公式计算：
最新成交价与 24 小时前那一分钟的K线开盘价相比的涨跌数值/ 24 小时前一分钟的K线开盘价*100% 。
可通过行情接口获取上述公式数据：https://www.okx.com/docs-v5/zh/#order-book-trading-market-data-get-ticker（last-open24h）/ open24h。
六、下单时报错：51000 Parameter posSide error 是什么原因？
需要先检查一下账户模式：单向持仓/双向持仓，可通过：https://www.okx.com/docs-v5/zh/#trading-account-rest-api-get-account-configuration 获取posMode查看。
1、在单向持仓下且使用合约下单情况下，posSide 参数必填，填写 long 或 short 。
2、如果是双向持仓，或者是在双向持仓下进行现货、杠杆交易posSide仅支持传入net或者是不传。
七、合约面值和最小下单数量可以通过哪个接口进行获取？
可以直接使用获取交易产品基础信息接口获取：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments 合约面值：ctVal，最小下单数量：minSz。
八、instId的格式是什么样的？
可以直接使用获取交易产品基础信息接口获取：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments
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 看跌期权
九、怎么设置止盈止损？
1、如果是下单附加止盈止损，可以参考下单接口：https://www.okx.com/docs-v5/zh/#order-book-trading-trade-post-place-order 的attachAlgoOrds数组参数。
2、如果是单独下单止盈止损，可以参考策略委托接口：https://www.okx.com/docs-v5/zh/#order-book-trading-algo-trading-post-place-algo-order。
十、设置止盈止损触发价时报错：51046、51047、51048、51049
止盈触发价/止损触发价设定规则：卖出时，止盈触发价大于最新成交价，止损触发价小于最新成交价；买入时，止盈触发价小于最新成交价，止损触发价大于最新成交价。
十一、接口报错：50102 Timestamp request expired
这是时间戳过期报错，需要您调用获取系统时间接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-system-time，将您的本地时间跟我们的服务器时间进行一下同步，时间差值控制在 30s 内就可以有效规避这个问题的，需要注意的是，请求头中的时间是UTC0 时的时间，获取服务器时间接口获取到的时间是 UTC+8 的时间戳。
十二、接口报错：50101 APIKey does not match current environment
这个是因为 APIKey 和当前环境不匹配导致的，实盘调用需要使用实盘 APIKey ，且请求的header 里面 x-simulated-trading这个参数值需要为 0 ；模拟盘调用需要使用模拟盘 APIKey ，且请求的 header 里面 x-simulated-trading 这个参数值需要为 1 。
十三、接口报错：51010 Request unsupported under current account mode
这个跟您的账户模式有关系，如果您要下单现货杠杆或合约，需要调整为除现货模式外的其他3种模式！您可以通过接口：https://www.okx.com/docs-v5/zh/#trading-account-rest-api-set-position-mode 设置，也可以在网页或 App 上设置；注意：首次设置必须要在页面或 App 上设置：交易页面右上角设置图标-账户模式。
十四、接口报错：51121 Order quantity must be a mult IP le of the lot size.
在 API 中合约下单是以张为单位的，必须是该币对最小下单数量的倍数，最小下单数量可以通过产品接口：https://www.okx.com/docs-v5/zh/#public-data-rest-api-get-instruments 的minSz 字段获取。
十五、提币报错：58207 Withdrawal address is not whitelisted for verification exemption；在提币页面关闭了白名单校验为什么还是会报错呢？
使用 API 接口提币是必须要在页面添加提币地址并勾选免验证按钮的，页面是否关闭白名单校验并不会影响接口功能。
十六、接口报错：50004 API endpoint request timeout (does not mean that the request was successful or failed, please check the request result)
50004一般是服务器压力过大导致，每天 8、16、24 点是资金费收取时间点，此时服务器压力较大，建议错开这几个整点进行交易，其他时刻报错 50004 可以稍后重试；如果遇到下单报错 50004，不代表接口请求实际结果，请求可能成功也可能失败，请您以实际结果为准！
温馨提示：
如果以上 QA 无法解答您的疑问，或您还有其他 API 相关问题，可以通过欧易 App 扫码联系我们！
打开 App，点击左上角全功能图标，再点击右上角扫码图标，扫描右侧二维码即可。
