永续合约API版本历史记录 – 火火币网怎么挂单交易币合约交易

2021-04-23 06:37:53 次浏览

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

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.esti火币网卖币后怎么提现mated_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



返回列表页>>> 比特币