关于V3 OpenAPI支持交割USDT保证金合约交易的公告

发布于 2019年10月30日阅读时长 3 分钟

亲爱的欧易OKX用户：

欧易OKX将于近期上线交割USDT保证金合约，为支持交割USDT保证金合约模拟盘及实盘交易，我们对现有API接口进行了相应的升级改造，预计2019年10月31日16:00(HKT)上线，API文档也会同时更新。模拟盘及实盘交易开放时间将于近期公布。

改造内容如下（此公告仅涉及到API交易用户，V1 OpenAPI 不支持USDT保证金合约交易）：

 1、改造内容： 

现状是：API接口无法通过请求参数区分‘币本位保证金合约’和‘USDT保证金合约’。

端口：GET /api/futures/v3/accounts/

示例：GET /api/futures/v3/accounts/BTC 

改造后：请求参数currency更换成underlying。币本位保证金合约的传参值为BTC-USD，USDT保证金合约的传参值为BTC-USDT

端口：GET /api/futures/v3/accounts/

USDT保证金合约示例：GET /api/futures/v3/accounts/BTC-USDT

币本位保证金合约示例：GET /api/futures/v3/accounts/BTC-USD

改造后，仍然兼容之前的请求格式，如果传入，等价于其目前对应的（标的指数）。

例如：GET /api/futures/v3/accounts/BTC 等价于 GET /api/futures/v3/accounts/BTC-USD

注意：restAPI 中“设置账户模式接口POST /api/futures/v3/accounts/margin_mode”不做兼容处理。使用此接口需要传相应的underlying。

 2、涉及的接口：restAPI 

a.单个币种合约账户信息 GET /api/futures/v3/accounts/ 

b.账单流水查询 GET /api/futures/v3/accounts//ledger

c.设定合约杠杆倍数（全仓） POST /api/futures/v3/accounts//leverage

d.获取合约币种杠杆倍数 GET /api/futures/v3/accounts//leverage

e.公共获取合约信息 GET /api/futures/v3/instruments - - - -返回值增加必要字段

f.设置合约账户模式 POST /api/futures/v3/accounts/margin_mode - - - -此接口不做兼容

g.获取所有币种合约账户信息 GET /api/futures/v3/accounts - - - -返回值增加必要字段

3、涉及的接口: WebsocketAPI

a.公共-全量合约信息频道 futures/instruments - - - - 返回值增加必要字段

b.个人-订阅账户信息频道 futures/account

示例：币本位保证金合约：{"op": "subscribe", "args": ["futures/account:BTC"]}

USDT保证金合约： {"op": "subscribe", "args": ["futures/account:BTC-USDT"]}

 如果您不交易USDT保证金合约，您的程序不会受影响。但是在接口中会有新的字段增加。给您带来的不便，敬请谅解！

 V3 API相较V1更稳定、效率更高、功能更全，且V1 Restful API 也将不期停止服务，建议用户优先使用V3 API 。如API使用过程中有任何问题或有任何API产品需求，欢迎添加WX：ApiSupport，备注：API+姓名+ok账号，我们将提供专业高效的技术支持服务。

欧易OKX将持续不断为您提供更优秀的产品和更优质的服务！

欧易OKX

 2019年10月30日 

加入欧易OKX社群 