关于火币合约API接口升级的公告

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

1.1.2 2020年4月9日 【增加:增加免鉴权的强平订单WS推送接口】

  • 接口名称:WS订阅强平订单(免鉴权)
  • 接口类型:公共接口
  • 订阅主题:public.$symbol.liquidation_orders

1.1.1 2020年3月12日 【增加:增加WS订阅推送指数K线数据接口;增加WS订阅推送基差数据接口;增加获取指数K线数据restful接口;增加获取基差数据restful接口】

1、增加WS订阅推送指数K线数据

  • 接口名称:WS指数K线推送
  • 接口类型:公共接口
  • 订阅主题:market.$symbol.index.$period

2、增加WS订阅推送基差数据

  • 接口名称:WS指数基差推送
  • 接口类型: 公共接口
  • 订阅主题:market.$symbol.basis.$period.$basis_price_type

3、增加restful接口获取指数K线数据

  • 接口名称: 获取指数K线数据
  • 接口类型: 公共接口
  • 接口URL:/index/market/history/index

4、增加restful接口获取基差数据

  • 接口名称:获取基差数据
  • 接口类型:公共接口
  • 接口URL:/index/market/history/basis

 

1.1.0 【增加:增加母子账号划转;增加多个下单类型;WS增加撮合订单推送】

1、在Web端和API端新增合约母子账户资产划转功能,Web端只有母账户有划转权限,可以进行母转子或者子转母,但是不能进行子账户之间相互划转。API端划转只能通过母账户的API Key进行母子账户的互相划转。

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

接口名称:母子账户划转
接口类型:私有接口
接口URL:api/v1/contract_master_sub_transfer

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

接口名称:查询系统状态
接口类型:公共接口
接口URL:api/v1/contract_api_state

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

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

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

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

2、合约资产接口和合约交易接口中涉及到更改的如下:

2.1、获取下单量限制的接口增加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:POST api/v1/contract_order_limit

2.2、合约下单接口增加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:api/v1/contract_order

2.3、合约批量下单接口增加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:api/v1/contract_batchorder

2.4、获取订单明细信息增加字段liquidation_type

接口名称:获取订单明细信息
接口类型:私有接口
接口URL:POST api/v1/contract_order_detail

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

接口名称:获取合约历史委托
接口类型:私有接口
接口URL:POST api/v1/contract_hisorders

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

接口名称:闪电平仓下单
接口类型:私有接口
接口URL:api/v1/lightning_close_position

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

接口名称:WS订单成交
接口类型:私有接口
订阅主题:orders.$symbol

2.8、增加WS撮合订单成交推送接口

接口名称:WS撮合订单成交推送
接口类型:私有接口
订阅主题:matchOrders.$symbol

2.9、查询系统是否可用接口,增加永续合约相关状态字段,在返回参数的数组"data"中,增加两个字段:"swap_heartbeat"、"swap_estimated_recovery_time"。

接口名称:查询系统是否可用
接口类型:公共接口
接口URL:https://www.hbdm.com/heartbeat

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

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

 

1.0.11 【更新:批量20个订单改成批量最多10个订单】

1、接口名称:合约批量下单

接口URL:api/v1/contract_batchorder

接口类型:私有接口

优化点:批量下单的请求参数“orders_data”的一次最多允许批量撤销订单数由20个改为10个。

2、接口名称:撤销订单

接口URL:api/v1/contract_cancel

接口类型:私有接口

优化点:撤单接口的请求参数“order_id” 与 “client_order_id” 的一次最多允许撤消订单数由20个改为10个,多个订单ID中间以","分隔。

 

1.0.10【更新:更改K线等接口】

  1. 获取K线数据的接口中增加了两个请求参数“from”和“to”,“from”表示开始时间点(时间戳精确到秒),“to”表示结束时间点(时间戳精确到秒),最多可获取连续两年的数据。请求参数“size”改为非必填项
  • /market/history/kline 获取K线数据
  1. 获取合约订单信息接口查询撤单信息,只能查询最近24小时内的撤单信息
  • /api/v1/contract_order_info 获取合约订单信息
  1. 历史委托查询接口查询撤单信息,只能查询最近24小时内的撤单信息
  • /api/v1/contract_hisorders 历史委托查询
  1. 获取订单明细接口查询撤单数据时,如果传“created_at”和“order_type”参数则能查询最近90天数据,如果不传“created_at”和“order_type”参数只能查询到最近24小时数据
  • /api/v1/contract_order_detail 获取订单明细

 

1.0.9【更新:新增计划委托接口】

  1. 新增查询资金持仓接口
  • rest接口api/v1/contract_account_position_info,用于获取到当前的资产和持仓信息
  1. 新增计划委托接口
  • api/v1/contract_trigger_order合约计划委托下单接口
  • api/v1/contract_ trigger_cancel合约计划委托撤单接口
  • api/v1/contract_trigger_cancelall合约计划委托全部撤单接口
  • api/v1/contract_trigger_openorders获取计划委托当前委托接口
  • api/v1/contract_trigger_hisorders获取计划委托历史委托接口
  1. 部分接口增加返回“手续费币种”字段

     部分API和内部接口增加返回字段表示手续费对应的币种:

  • api/v1/contract_fee查询用户当前的手续费费率
  • api/v1/contract_order_info获取合约订单信息
  • api/v1/contract_order_detail获取订单明细
  • api/v1/contract_openorders获取合约当前未成交委托
  • api/v1/contract_hisorders获取合约历史委托
  • api/v1/contract_matchresults获取历史成交记录
  • WS成交推送,增加返回“手续费币种”字段
  1. 部分接口请求参数的天数改为可随意输入

      部分接口的请求参数“create_date”,由只能填写7或90 改为 可随意输入正整数,如果参数超过90则              默认查询90天的数据:

  • api/v1/contract_hisorders获取限价单历史委托的接口
  • api/v1/contract_trigger_hisorders获取计划委托的历史委托接口
  • api/v1/contract_matchresults获取成交记录的接口
  • api/v1/contract_financial_record获取财务记录的接口

 

 

1.0.8【更新:增加order_id_str字段】

  1. 为了解决nodejs和Javascript的用户order_id返回是18位数字长度过长的问题,接口返回增加order_id_str字段,类型为字符串,来表示订单号
    涉及接口:
  • api/v1/contract_order
  • api/v1/contract_batchorder
  • api/v1/contract_matchresults
  • api/v1/contract_hisorders
  • api/v1/contract_openorders
  • api/v1/lightning_close_position
  • api/v1/contract_order_info
  1. 订单推送ws 增加 order_id_str

 

1.0.7【更新:新增FOK、IOC】

nodejs和Javascript的用户请特别注意:order_id返回是18位,nodejs和javascript默认解析18位有问题,nodejs和javascript里面JSON.parse默认是int,大于等于18位的数字用json-bigint的包解析。具体参考nodejs的demo,点击查看。 详细说明,请点击查看

  1. 修改获取订单明细信息
  • rest接口api/v1/contract_order_detail请求参数“ created_at”改为选填
  1. 修改接口获取用户账户信息
  • rest接口api/v1/contract_account_info增加返回字段‘ margin_static’,表示用户的静态权益
  1. 修改获取订单明细信息
  • rest接口api/v1/contract_order_detail、查询用户的成交记录
  • rest接口api/v1/contract_matchresults、用户订单的成交推送的ws增加字段id,表示成交唯一ID
  1. 修改下单
  • rest接口api/v1/contract_order和批量下单
  • rest接口api/v1/contract_batchorder
  • 请求参数order_price_type中增加订单价格类型“ioc”;
  • 请求参数order_price_type中增加订单价格类型“fok”;
  1. 修改查询用户当前的下单量限制
  • rest接口api/v1/contract_order_limit返回参数的“ order_price_type”,表示订单报价类型,
  • 增加"fok":FOK订单,"ioc":IOC订单
  1. 新增查询系统状态的API
  • rest接口api/v1/contract_api_state
  1. 新增账户多空持仓对比-账户数
  • rest接口api/v1/contract_elite_account_ratio
  1. 新增精英账户多空持仓对比-持仓量
  • rest接口api/v1/contract_elite_position_ratio
  1. 新增获取强平订单
  • rest接口api/v1/contract_liquidation_orders和ws推送

 

1.0.6【更新:新增rest接口】

      1.新增rest接口:

1.0.5【更新:查询及下单功能】

  1. 新增接口:
  • 新增rest接口,查询用户的下单量限制;
  • 新增rest接口,查询用户的手续费费率;
  • 新增rest接口,查询用户的划转限制;
  • 新增rest接口,查询用户的持仓量限制;
  • 新增rest接口,查询平台的风险准备金、预估分摊比例;
  • 新增rest接口,查询平台持仓量;
  • 新增rest接口,查询平台的风险准备金历史数据;
  • 新增rest接口,查询平台的阶梯调整系数;
  • 新增rest接口,闪电平仓下单;
  1. 对已有接口的修改:
  • rest接口,查询用户账户信息接口增加返回用户的调整系数;
  • rest接口,查询单个子账户资产信息接口增加返回用户的调整系数;
  • ws接口,资金推送增加返回用户的调整系数;
  • rest接口,下单接口和批量下单接口新增最优5、10、20档下单;
  • rest接口,获取成交记录增加按照合约code查询;

 

1.0.4【更新: Restful查询接口】

      1.查询母账户下所有子账户资产信息

  • URL:api/v1/contract_sub_account_list
  • 备注:只返回已经开通合约交易的子账户数据

      2.查询单个子账户资产信息

  • URL:api/v1/contract_sub_account_info
  • 备注:只能查询到开通合约交易的子账户信息;子账户来过合约系统但是未开通合约交易也不返回对应的数据

      3.查询单个子账户持仓信息的

  • URL:api/v1/contract_sub_position_info

      4.查询用户财务记录

  • URL:api/v1/contract_financial_record

1.0.3【更新:WS增加资产信息推送】

  • WS增加资产信息推送 
  • WS增加持仓信息推送 
  • rest接口获取用户的持仓信息接口api/v1/contract_position_info增加返回字段“最新价”

 

1.0.2【更新:  币币账户和合约账户间进行资金的划转】

  1. 账户接口/v1/futures/transfer 
  • 币币账户和合约账户间进行资金的划转
  • 从现货现货账户转至合约账户,类型为pro-to-futures; 从合约账户转至现货账户,类型为futures-to-pro
  • 该接口的访问频次的限制为1分钟10次
  1. API限频
  • 限频时间间隔从1秒变为3秒
  • 私有接口限频由原来的10次/s变更为30次/3s,即请求发送3秒内不超过30次
  • 其他非行情类的公开接口限频由原来的20次/s变更为60次/3s,即请求发送3秒内不超过60次

 

1.0.1【更新:post_only高级限价委托功能上线】

  1. 全部撤单接口/v1/contract_cancelall
  • 只传symbol,撤该该品种下所有周期的合约
  • 只要有contract_code,则撤销该code的合约
  • 只传symbol+contract_type, 则撤销二者拼接所成的合约订单
  1. 下单接口/v1/ contract_order
  • 报单字段order_price_type中增加订单价格类型post_only,post_only是“只做Maker(post_only)”,不会立刻在市场成交,保证用户始终为Maker;如果委托会立即与已有委托成交,那么该委托会被取消。
  • Post only只受用户持仓数量限制,单笔下单不受下单数量限制。
  1. 批量下单接口/v1/ contract_batchorder
  • 报单字段order_price_type中增加订单价格类型post_only,post_only是“只做Maker(post_only)”,不会立刻在市场成交,保证用户始终为Maker;如果委托会立即与已有委托成交,那么该委托会被取消。
  • Post only只受用户持仓数量限制,单笔下单不受下单数量限制。
  1. 所有API接口返回数据中增加限频信息
  • 将在api接口response中的header返回以下字段
  • ratelimit-limit: 单轮请求数上限,单位:次数
  • ratelimit-interval:请求数重置的时间间隔,单位:毫秒
  • ratelimit-remaining:本轮剩余可用请求数,单位:次数
  • ratelimit-reset:请求数上限重置时间,单位:毫秒
  1. 查询订单详细信息/v1/contract_order_detail
  • trades增加成交角色字段role:taker或maker
  1. 获取成交记录/v1/contract_matchresults
  • trades增加成交角色字段role:taker或maker
  • 获取该用户在某品种上的最新成交记录,可以按照交易类型进行过滤筛选。注意,该接口是需要API KEY验签的私有接口,只能查询属于该用户自己的最新成交记录。
  1. WS成交推送接口
  • trades增加成交角色字段role:taker或maker
  1. WebSocket私有订单成交推送接口(需要API KEY验签)
  • 一个UID最多同时建立10个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上,仅需要维持一个订单推送WS链接即可。
  • 注意: 订单推送WS的限频,跟用户RESTFUL私有接口的限频是分开的,相互不影响。

 

1.0.0 于2018年12月10日上线