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，点击左上角全功能图标，再点击右上角扫码图标，扫描右侧二维码即可。
