币本位永续合约API版本历史记录

 交易常见问题    |      2021-02-04

API接入:https://huobiglobal.zendesk.com/hc/zh-cn/articles/360000188382

1.1.4 2021年1月29日 【新增:批量获取聚合行情接口、获取标记价格的 K 线数据、订阅标记价格 K 线数据 WS 接口、请求标记价格 K 线数据 WS 接口。5-17 修改接口,新增字段。修改:计划委托订单的订单ID由原本的自然数自增ID 改为长度为 18 位的唯一标识ID。推荐使用下单后返回的 order_id_str(字符串类型的订单 ID),避免发生长度过大而被系统截断的情况。】

1、新增批量获取聚合行情接口

  • 接口名称:批量获取聚合行情
  • 接口类型:公共接口
  • 接口URL:/swap-ex/market/detail/batch_merged

2、新增获取标记价格的 K 线数据

  • 接口名称:获取标记价格的 K 线数据
  • 接口类型:公共接口
  • 接口URL:/index/market/history/swap_mark_price_kline

3、新增订阅标记价格 K 线数据 WS 接口

  • 接口名称:订阅标记价格 K 线数据
  • 接口类型:公共接口
  • 订阅地址:market.$contract_code.mark_price.$period

4、新增请求标记价格 K 线数据 WS 接口

  • 接口名称:请求标记价格 K 线数据
  • 接口类型:公共接口
  • 订阅地址:market.$contract_code.mark_price.$period

5、修改全部撤单接口(请求参数新增 2 个选填字段:direction,表示买卖方向,不填默认撤销全部。参数可选值为“buy”:买,“sell”:卖。offset,表示开平方向,不填默认撤销全部。参数可 选值为“open”:开仓,“close”:平仓。)

  • 接口名称:全部撤单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_cancelall

6、修改获取合约订单信息接口(返参data中新增real_profit字段,表示真实收益,类型decimal)

  • 接口名称:获取合约订单信息
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_order_info

7、修改获取订单明细信息接口(返回参数中的 data 和 trades 下各新增以下字段:real_profit(真实收益)。同时 trades 下新增每笔成交收益字段:profit(平仓盈亏))

  • 接口名称:获取订单明细信息
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_order_detail

8、修改获取合约当前未成交委托接口(请求参数新增 2 个选填字段:sort_by,表示排序字段,不填默认按创建时间倒序。参数可选值为“created_at”(按照创建时间倒序),“update_time”(按照更新时间倒 序)。trade_type,表示交易类型,不填默认查询全部。参数可选值为 0:全部,1:买入 开多,2: 卖出开空,3: 买入平空,4: 卖出平多。 返回参数中的 orders 下新增以下字段:update_time(订单更新时间,单位毫秒)、 real_profit(真实收益)。)

  • 接口名称:获取合约当前未成交委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_openorders

9、修改获取合约历史委托接口(返参orders中新增real_profit字段,表示真实收益,类型decimal)

  • 接口名称:获取合约历史委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_hisorders

10、修改组合查询合约历史委托接口(返参orders中新增real_profit字段,表示真实收益,类型decimal)

  • 接口名称:组合查询合约历史委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_hisorders_exact

11、修改获取历史成交记录接口(返参trades中新增real_profit字段,表示真实收益,类型decimal)

  • 接口名称:获取历史成交记录
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_matchresults

12、修改组合查询历史成交记录接口(返参trades中新增real_profit字段,表示真实收益,类型decimal)

  • 接口名称:组合查询历史成交记录
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_matchresults_exact

13、修改订阅订单成交数据接口(返参外层新增real_profit字段,表示真实收益,类型decimal.返参trade中新增:real_profit字段,表示真实收益、profit字段,表示平仓盈亏。)

  • 接口名称:订阅订单成交数据
  • 接口类型:私有接口
  • 订阅地址:orders.$contract_code

14、修改计划委托全部撤单接口(请求参数新增2个选填字段:direction,表示买卖方向,不填默认撤销全部。参数可选值为“buy”:买,“sell”:卖。offset,表示开平方向,不填默认撤销全部。参数可 选值为“open”:开仓,“close”:平仓。)

  • 接口名称:计划委托全部撤单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_trigger_cancelall

15、修改止盈止损订单全部撤单接口(请求参数新增选填字段:direction,表示买卖方向,不填默认撤销全部。参数可选值为“buy”:买,“sell”:卖。)

  • 接口名称:止盈止损订单全部撤单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_tpsl_cancelall

16、修改查询计划委托当前委托接口(请求参数新增选填字段:trade_type,表示交易类型,不填默认查询全部。参数可选值为 0:全部,1:买入开多,2: 卖出开空,3: 买入平空,4: 卖出平多。)

  • 接口名称:查询计划委托当前委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_trigger_openorders

17、修改查询止盈止损订单当前委托接口(请求参数新增选填字段:trade_type,表示交易类型,不填默认查询全部。参数可选值为 0:全部,3: 买入平空,4: 卖出平多。)

  • 接口名称:查询止盈止损订单当前委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_tpsl_openorders

 

 

 

1.1.3 2021年01月12号 【1 新增获取预估结算价。2-7 新增止盈止损订单接口。8-21 修改接口,新增字段。 新增【合约策略订单】一级菜单,将本次新增的双向止盈止损相关接口以及原有的计划委托相关接口挪到该菜单下】

1、新增获取预估结算价

  • 接口名称: 获取预估结算价
  • 接口类型: 公共接口
  • 接口URL: /swap-api/v1/swap_estimated_settlement_price

2、新增对仓位设置止盈止损订单

  • 接口名称: 对仓位设置止盈止损订单
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_tpsl_order

3、新增止盈止损订单撤单接口

  • 接口名称: 止盈止损订单撤单
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_tpsl_cancel

4、新增止盈止损订单全部撤单接口

  • 接口名称: 止盈止损订单全部撤单
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_tpsl_cancelall

5、新增查询止盈止损订单当前委托接口

  • 接口名称: 查询止盈止损订单当前委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_tpsl_openorders

6、新增查询止盈止损订单历史委托接口

  • 接口名称: 查询止盈止损订单历史委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_tpsl_hisorders

7、新增查询开仓单关联的止盈止损订单详情接口

  • 接口名称: 查询开仓单关联的止盈止损订单详情
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_relation_tpsl_order

8、修改合约下单接口(新增选填入参:tp_trigger_price(止盈触发价格)、tp_order_price(止盈委托价格)、tp_order_price_type(止盈委托类型)、sl_trigger_price(止损触发价格)、sl_order_price(止损委托价格)、sl_order_price_type(止损委托类型)。)

  • 接口名称: 合约下单
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_order

9、修改合约批量下单接口(在入参orders_data中新增选填参数:tp_trigger_price(止盈触发价格)、tp_order_price(止盈委托价格)、tp_order_price_type(止盈委托类型)、sl_trigger_price(止损触发价格)、sl_order_price(止损委托价格)、sl_order_price_type(止损委托类型)。)

  • 接口名称: 合约批量下单
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_batchorder

10、修改获取合约订单信息接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 获取合约订单信息
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_order_info

11、修改获取订单明细信息接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 获取订单明细信息
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_order_detail

12、修改获取合约当前未成交委托接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 获取合约当前未成交委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_openorders

13、修改获取合约历史委托接口(新增入参:sort_by(表示:排序字段,可选值为“create_date”,“update_time”)。新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),update_time(表示:订单的更新时间),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 获取合约历史委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_hisorders

14、修改组合查询合约历史委托接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 组合查询合约历史委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_hisorders_exact

15、修改订阅订单成交数据接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 订阅订单成交数据
  • 接口类型: 私有接口
  • 订阅主题: orders.$contract_code

16、修改订阅订单撮合数据接口(新增返回参数:is_tpsl(表示是否设置止盈止损,1:是;0:否),在返回参数order_source订单来源新增枚举值(tpsl:止盈止损触发))

  • 接口名称: 订阅订单撮合数据
  • 接口类型: 私有接口
  • 订阅主题: matchOrders.$contract_code

17、修改获取计划委托历史委托接口(新增入参:sort_by(表示:排序字段,可选值为“created_at”,“update_time”)。新增返回参数:update_time(表示:订单的更新时间))

  • 接口名称: 获取计划委托历史委托
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_trigger_hisorders

18、修改获取当前可用合约总持仓量(在返回参数data中新增trade_volume:最近24小时成交量(张),trade_amount:最近24小时成交量(币),trade_turnover:最近24小时成交额。这三个字段 )

  • 接口名称: 获取当前可用合约总持仓量
  • 接口类型: 公共接口
  • 接口URL: /swap-api/v1/swap_open_interest

19、修改订阅Market Detail数据(在返参tick中新增ask表示卖一,bid表示买一。)

  • 接口名称: 订阅Market Detail数据
  • 接口类型: 公共接口
  • 订阅主题: market.$contract_code.detail

20、修改获取合约信息(在返参data下新增delivery_time,表示交割时间(毫秒时间戳))

  • 接口名称: 获取合约信息
  • 接口类型: 公共接口
  • 接口URL: /swap-api/v1/swap_contract_info

21、修改订阅合约信息变动(在返参data下新增delivery_time,表示交割时间(毫秒时间戳))

  • 接口名称: 订阅合约信息变动
  • 接口类型: 公共接口
  • 订阅主题: public.$contract_code.contract_info

 

 

1.1.2 2020年12月2日 【修改获取订单明细信息接口(查询无成交撤单数据时,如果不传“created_at”和“order_type”参数,由原来的只能查询到最近12小时数据,改为只能查询到最近2小时数据);修改获取合约历史委托接口(查询无成交撤单数据时,由原来的只保留最近24小时数据,改为只保留最近2小时数据。);修改组合查询合约历史委托接口(查询无成交撤单数据时,由原来的只保留最近24小时数据,改为只保留最近2小时数据。)】

1、修改获取订单明细信息接口(查询无成交撤单数据时,如果不传“created_at”和“order_type”参数,由原来的只能查询到最近12小时数据,改为只能查询到最近2小时数据)

  • 接口名称:获取订单明细信息
  • 接口类型:私有接口
  • 接口URL:swap-api/v1/swap_order_detail

2、修改获取合约历史委托接口(查询无成交撤单数据时,由原来的只保留最近24小时数据,改为只保留最近2小时数据。)

  • 接口名称:获取合约历史委托
  • 接口类型:私有接口
  • 接口URL:swap-api/v1/swap_hisorders

3、修改组合查询合约历史委托接口(查询无成交撤单数据时,由原来的只保留最近24小时数据,改为只保留最近2小时数据。)

  • 接口名称:组合查询合约历史委托
  • 接口类型:私有接口
  • 接口URL:swap-api/v1/swap_hisorders_exact

 

1.1.1 2020年11月24日 【新增:查询平台历史结算记录;修改:获取强平订单接口新增返参字段,订阅强平订单数据接口新增返参字段】

1、新增查询平台历史结算记录接口

  • 接口名称:查询平台历史结算记录
  • 接口类型:公共接口
  • 接口URL:swap-api/v1/swap_settlement_records

2、获取强平订单接口新增返参字段(返回参数中的 orders 参数下增加 amount 字段,表示强平数量(币))

  • 接口名称:获取强平订单接口
  • 接口类型:公共接口
  • 接口URL:swap-api/v1/swap_liquidation_orders

3、订阅强平订单数据接口新增返参字段(返回参数中的data参数下增加amount字段,表示强平数量(币))

  • 接口名称:订阅强平订单数据
  • 接口类型:公共接口
  • 订阅主题:public.$contract_code.liquidation_orders

 

 

1.1.0 2020年10月28日 【新增:组合查询财务记录接口、组合查询合约历史委托接口、组合查询历史成交记录接口】

1、组合查询合约历史成交记录

  • 接口名称:组合查询合约历史成交记录
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_matchresults_exact

2、组合查询合约历史委托

  • 接口名称:组合查询合约历史委托
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_hisorders_exact

3、组合查询财务记录

  • 接口名称:组合查询财务记录
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_financial_record_exact

 

 

1.0.9 2020年10月15日 【新增:切换杠杆倍数接口;修改:切换倍数成功时 WS 资产接口推送更新信息,切换倍数成功时 WS 持仓接口推送更新信息,订单撮合推送接口新增返参字段,获取合约订单信息接口(将原支持查询 24小时的撤单数据改为支持查询 4 小时撤单数据)】

1、新增切换倍数接口

  • 接口名称:切换倍数
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_switch_lever_rate

2、订阅资产接口推送更新(返参event新增事件类型,switch_lever_rate表示切换倍数。在用户切换倍数成功时,需推送一次最新的资产信息,event为switch_lever_rate。)

  • 接口名称:订阅资产变动数据
  • 接口类型:私有接口
  • 订阅主题:$contract_code

3、订阅持仓接口推送更新(返参event新增事件类型,switch_lever_rate表示切换倍数。在用户切换倍数成功时,需推送一次最新的持仓信息(若用户持仓量为0,则不会触发推送),event 为 switch_lever_rate。)

  • 接口名称:订阅持仓变动数据
  • 接口类型:私有接口
  • 订阅主题:$contract_code

4、订阅订单撮合推送接口更新(返回参数新增以下字段:direction(买卖方向)、offset(开平方向)、lever_rate(倍数)、price(委托价格)、created_at(创建时间)、order_source (订单来源)、order_price_type(订单报价类型)。)

  • 接口名称:订阅订单撮合推送
  • 接口类型:私有接口
  • 订阅主题:$contract_code

5、获取合约订单信息接口(将原支持查询 24小时的撤单数据改为支持查询 4 小时撤单数据)

  • 接口名称:获取合约订单信息
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_order_info

 

1.0.8 2020年10月10日【新增:订阅系统状态更新推送的WebSocket接口】

1、新增订阅系统状态更新推送的 WebSocket 接口

  • 接口名称:订阅系统状态更新
  • 接口类型: 公共接口
  • 订阅主题:public.$service.heartbeat

 

1.0.7 2020年8月6日【新增:买一卖一逐笔行情 WS 接口;查询用户可用杠杆倍数;订阅计划委托订单更新接口】

1、新增买一卖一逐笔行情 WS 接口

  • 接口名称:订阅买一卖一逐笔行情推送
  • 接口类型:公共接口
  • 订阅主题:market.$contract_code.bbo

2、查询用户可用杠杆倍数

  • 接口名称:查询用户可用杠杆倍数
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_available_level_rate

3、查询用户结算记录

  • 接口名称:查询用户结算记录
  • 接口类型:私有接口
  • 接口地址:swap-api/v1/swap_user_settlement_records

4、订阅计划委托订单更新

  • 接口名称:订阅计划委托订单更新
  • 接口类型:私有接口
  • 订阅主题:trigger_order.$contract_code

 

1.0.6 2020年6月19日【订阅订单撮合数据接口在返回参数外层新增client_order_id字段】

1、订阅订单撮合数据接口在返回参数外层新增client_order_id字段

  • 接口名称:订阅订单撮合数据
  • 接口类型:私有接口
  • 订阅主题:$contract_code

 

1.0.5 2020年6月14日 【新增计划委托下单等多个接口;新增溢价指数K线的restful以及ws接口;新增预测资金费率K线等restful及ws接口;新增撮合订单推送接口;新增基差数据restful及ws接口;新增仓位与账户定期推送5秒推送1次;新增多个接口返回字段,更多请看详情】

1、新增溢价指数K线的restful接口。

  • 接口名称:获取溢价指数K线数据接口
  • 接口类型: 公开接口
  • restful请求:GET请求 swap-api/v1/swap_premium_index_kline。

2、新增溢价指数K线的ws请求接口。

  • 接口名称:获取溢价指数K线数据ws请求接口
  • 接口类型: 公开接口
  • ws请求接口:req market.$contract_code.premium_index.$period。

3、新增溢价指数K线的ws订阅推送接口。

  • 接口名称:订阅溢价指数K线数据接口
  • 接口类型: 公开接口
  • ws订阅接口:sub market.$contract_code.premium_index.$period。

4、新增预测资金费率K线的restful接口。

  • 接口名称:获取预测资金费率K线数据接口
  • 接口类型: 公开接口
  • restful请求:GET请求 swap-api/v1/swap_estimated_rate_kline。

5、新增预测资金费率K线的ws请求接口。

  • 接口名称:获取预测资金费率K线数据ws请求接口
  • 接口类型: 公开接口
  • ws请求接口:req market.$contract_code.estimated_rate.$period。

6、新增预测资金费率K线的ws订阅推送接口。

  • 接口名称:订阅预测资金费率K线数据推送接口
  • 接口类型: 公开接口
  • ws订阅接口:sub market.$contract_code.estimated_rate.$period。

7、新增获取基差数据的restful接口。

  • 接口名称:获取基差数据接口
  • 接口类型: 公开接口
  • restful请求:GET请求 /index/market/history/swap_basis。

8、新增获取基差数据的ws请求接口。

  • 接口名称:获取基差数据ws接口
  • 接口类型: 公开接口
  • ws请求接口:req market.$contract_code.basis.$period.$basis_price_type。

9、新增获取基差数据的ws订阅推送接口。

  • 接口名称:订阅基差数据推送接口
  • 接口类型: 公开接口
  • ws订阅接口:sub market.$contract_code.basis.$period.$basis_price_type。

10、获取合约的历史资金费率接口新增“平均溢价指数”字段

  • 接口名称:获取合约的历史资金费率
  • 接口URL:swap-api/v1/swap_historical_funding_rate
  • 修改内容: 新增avg_premium_index 字段,表示平均溢价指数。

11、订阅 Market Depth 接口新增4个深度类型可选值

  • 接口名称:ws订阅 Market Depth 数据
  • 接口方法:market.$contract_code.depth.$type
  • 修改内容:请求参数 type 深度类型新增 4 个可选值:step12(表示合并精度 1 的 20 档深度数据,表示整数位的个位)、step13(表示合并精度 10 的 20 档深度数据,表示整数位的十位)、step14(表示合并精度 1 的 150 档深度数据,表示整数位的个位)、step15(表示合并精度 10 的 150 档深度数据,表示整 数位的十位)。

12、资产变动的WS接口新增定期推送

  • 接口名称:订阅资产变动数据
  • 接口方法:accounts.$contract_code
  • 修改内容:推送接口新增定期推送逻辑,每 5 秒进行一次定期推送,由定期推送触发的数据中 event 参数值为“snapshot”,表示由系统定期推送触发。 如果 5 秒内已经触发过推送,则跳过该次定期推送。

13、持仓变动的WS接口新增定期推送

  • 接口名称:订阅持仓变动数据
  • 接口方法:positions.$contract_code
  • 修改内容:推送接口新增定期推送逻辑,每 5 秒进行一次定期推送,由定期推送触发的数据中 event 参数值为“snapshot”,表示由系统定期推送触发。 如果 5 秒内已经触发过推送,则跳过该次定期推送。

14、优化查询订单相关接口的返回参数

获取订单明细信息接口

  • 接口名称:获取订单明细信息
  • 接口URL:swap-api/v1/swap_order_detail
  • 修改内容: 在返回参数的数组"data"中,增加 8 个字段:order_id(订单 id)、order_id_str(string 格式的订单 id)、client_order_id(客户订单 id)、order_type(订 单类型)、status(订单状态)、trade_avg_price(成交均价)、trade_turnover (成交总金额)、trade_volume(成交总数量)。

获取订单信息接口

  • 接口名称:获取订单信息接口
  • 接口URL:swap-api/v1/swap_order_info
  • 修改内容:在返回参数的数组"data"中,增加 2 个字段:liquidation_type(强平类型)、canceled_at(撤单时间)。

订阅成交订单推送接口

  • 接口名称:订阅成交订单推送
  • 接口URL:orders.$contract_code
  • 修改内容:在返回参数的外层,增加 2 个字段:canceled_at(撤单时间)、fee_asset(手续费币种)。

15、私有推送接口新增返回参数'uid'

  • 接口名称:订阅成交订单推送,订阅资产变动推送,订阅持仓变动推送,订阅订单撮合推送
  • 接口方法:orders.$contract_code,accounts.$contract_code,positions.$contract_code,matchOrders.$contract_code
  • 修改内容:在返回参数增加 uid 字段,表示用户 uid。

16、新增新增合约计划委托下单接口

  • 接口名称:合约计划委托下单接口
  • 接口类型:私有接口
  • 接口方法:swap-api/v1/swap_trigger_order

17、新增合约计划委托撤单接口

  • 接口名称:合约计划委托撤单接口
  • 接口类型:私有接口
  • 接口方法:swap-api/v1/swap-api/v1/swap_trigger_cancel

18、新增合约计划委托全部撤单接口

  • 接口名称:合约计划委托全部撤单接口
  • 接口类型:私有接口
  • 接口方法:swap-api/v1/swap-api/v1/swap_trigger_cancelall

19、新增获取计划委托当前委托接口

  • 接口名称:获取计划委托当前委托接口
  • 接口类型:私有接口
  • 接口方法:swap-api/v1/swap-api/v1/swap_trigger_openorders

20、新增获取计划委托历史委托接口

  • 接口名称:获取计划委托当前委托接口
  • 接口类型:私有接口
  • 接口方法:swap-api/v1/swap-api/v1/swap_trigger_hisorders

21、新增订单撮合数据 WS 推送

  • 接口名称:订阅订单撮合数据接口
  • 接口类型:私有接口
  • 接口方法:matchOrders.$contract_code

1.0.4 2020年5月27日【增加合约信息变动WS推送接口】

1、增加合约信息变动ws推送接口

  • 接口名称:增加合约信息变动ws推送接口
  • 接口类型:公开接口
  • 订阅主题:public.$contract_code.contract_info

 

1.0.3 2020年5月7日【增加查询用户账户和持仓信息】

1、增加查询用户账户和持仓信息

  • 接口名称:查询用户账户和持仓信息
  • 接口类型: 私有接口
  • 接口URL: /swap-api/v1/swap_account_position_info

 

1.0.2 2020年4月9日【增加免鉴权的资金费率WS推送接口;增加免鉴权的强平订单WS推送接口】

1、增加免鉴权的资金费率WS推送接口

  • 接口名称: 订阅资金费率推送(免鉴权)
  • 接口类型: 公开接口
  • 订阅主题: public.$contract_code.funding_rate

2、增加免鉴权的强平订单WS推送接口

  • 接口名称: 订阅强平订单推送(免鉴权)
  • 接口类型: 公开接口
  • 订阅主题: public.$contract_code.liquidation_orders

 

1.0.1 2020年3月20日

1、首次使用高倍杠杆(>20倍),请使用主账号登录web端同意高倍杠杆协议。然后再使用API进行高杠杆倍数(>20倍)下单。

2、websocket订单与用户数据接口鉴权签名路径变更,签名构建由原/notification变更为/swap-notification。

  • 接口名称:ws订单与用户数据下所有接口
  • 接口类型:私有接口
  • 鉴权路径:/swap-notification

3、增加websocket订阅增量市场orderbook数据接口,分为20档和150档不合并数据,每30MS检查一次更新,若有更新则推送。

  • 接口名称:订阅Market Depth增量数据
  • 接口类型:公开接口
  • 订阅主题:market.$contract_code.depth.size_${size}.high_freq

4、增加获取用户的API指标禁用信息的API接口。

  • 接口名称:获取用户的API指标禁用信息
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_api_trading_status

5、增加websocket订阅资金费率接口,资金费率有更新时会推送信息。

  • 接口名称:订阅资金费率
  • 接口类型:私有接口
  • 订阅主题:funding_rate.$contract_code

6、获取下单量限制的接口增加10种订单价格类型,包括:opponent_ioc(对手价-IOC下单),lightning_ioc(闪电平仓-IOC下单),optimal_5_ioc(最优5档-IOC下单),optimal_10_ioc(最优10档-IOC下单),optimal_20_ioc(最优20档-IOC下单),opponent_fok(对手价-FOK下单),lightning_fok(闪电平仓-FOK下单),optimal_5_fok(最优5档-FOK下单),optimal_10_fok(最优10档-FOK下单),optimal_20_fok(最优20档-FOK下单)。

  • 接口名称:查询用户当前的下单量限制
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_order_limit

7、合约下单接口增加8种订单价格类型,分别为:opponent_ioc(对手价-IOC下单),optimal_5_ioc(最优5档-IOC下单),optimal_10_ioc(最优10档-IOC下单),optimal_20_ioc(最优20档-IOC下单),opponent_fok(对手价-FOK下单),optimal_5_fok(最优5档-FOK下单),optimal_10_fok(最优10档-FOK下单),optimal_20_fok(最优20档-FOK下单)。

  • 接口名称:合约下单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_order

8、合约批量下单接口增加8种订单价格类型,分别为:opponent_ioc(对手价-IOC下单),optimal_5_ioc(最优5档-IOC下单),optimal_10_ioc(最优10档-IOC下单),optimal_20_ioc(最优20档-IOC下单),opponent_fok(对手价-FOK下单),optimal_5_fok(最优5档-FOK下单),optimal_10_fok(最优10档-FOK下单),optimal_20_fok(最优20档-FOK下单)。

  • 接口名称:合约批量下单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_batchorder

9、闪电平仓下单接口请求参数增加字段order_price_type,值分别为:lightning_ioc(闪电平仓-IOC下单),lightning_fok(闪电平仓-FOK下单),lightning(闪电平仓-默认值)。

  • 接口名称:闪电平仓下单
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_lightning_close_position

10、获取订单明细信息返回的data字典中增加字段强平类型:liquidation_type, 所有成交的手续费:fee,手续费币种:fee_asset。

  • 接口名称:获取订单明细信息
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_order_detail

11、获取合约历史委托trade_type和orders修改,请求参数的trade_type中,增加类型:减仓平多,减仓平空;返回参数的orders数组元素增加字段"liquidation_type"。

  • 接口名称:获取合约历史委托
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_hisorders

12、WS订单成交推送增加字段liquidation_type。

  • 接口名称:WS订阅订单成交推送
  • 接口类型:私有接口
  • 接口URL:orders.$symbol

13、增加母子账户划转的API接口,母账户与每个子账户相互划转限频10次/分钟。

  • 接口名称:母子账户划转
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_master_sub_transfer

14、查询系统状态的接口增加母子划转权限参数,在返回参数的数组"data"中,增加两个字段:"master_transfer_sub"、"sub_transfer_master"。

  • 接口名称:查询系统状态
  • 接口类型:公共接口
  • 接口URL:/swap-api/v1/swap_api_state

15、增加查询母账户下的所有母子账户的划转记录的功能。

  • 接口名称:获取母账户下的所有母子账户划转记录
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_master_sub_transfer_record

16、返回财务记录的接口中,增加返回4种母子账户划转的流水。

  • 接口名称:查询用户财务记录
  • 接口类型:私有接口
  • 接口URL:/swap-api/v1/swap_financial_record