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

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

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

来源:火币网

点击注册火币网Huobi

郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。

郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。

留言与评论(共有 0 条评论)
   
验证码:
微信号已复制,请打开微信添加咨询详情!