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 扫码联系我们！