火幣幣本位交割合約API版本歷史記錄

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

1.2.3 2021129 【新增:批量獲取聚合行情接口。 2-14 修改接口,新增字段。修改:計劃委託訂單的訂單ID由原本的自然數自增ID 改為長度為 18 位的唯一標識ID。推薦使用下單後返回的 order_id_str(字符串類型的訂單 ID),避免發生長度過大而被系統截斷的情況。】

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

  • 接口名稱:批量獲取聚合行情
  • 接口類型:公共接口
  • 接口URL:/market/detail/batch_merged

2、修改全部撤單接口(請求參數新增 2 個選填字段:direction,表示買賣方向,不填默認撤銷全部。參數可選值為“buy”:買,“sell”:賣。 offset,表示開平方向,不填默認撤銷全部。參數可 選值為“open”:開倉,“close”:平倉。)

  • 接口名稱:全部撤單
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_cancelall

3、修改獲取合約訂單信息接口(返參data中新增real_profit字段,表示真實收益,類型decimal

  • 接口名稱:獲取合約訂單信息
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_order_info

4、修改獲取訂單明細信息接口(返回參數中的 data trades 下各新增以下字段:real_profit(真實收益)。同時 trades 下新增每筆成交收益字段:profit(平倉盈虧))

  • 接口名稱:獲取訂單明細信息
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_order_detail

5、修改獲取合約當前未成交委託接口(請求參數新增選填 2 個字段:sort_by,表示排序字段,不填默認按創建時間倒序。參數可選值為“created_at”(按照創建時間倒序)“update_time”(按照更新時間倒 )trade_type,表示交易類型,不填默認查詢全部。參數可選值為 0:全部,1:買入開多,2: 賣出開空,3: 買入平空,4: 賣出平多。返回參數中的 orders 下新增以下字段:update_time(訂單更新時間,單位毫秒) real_profit(真實收益)。)

  • 接口名稱:獲取合約當前未成交委託接口
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_openorders

6、修改獲取合約歷史委託接口(返參orders中新增real_profit字段,表示真實收益,類型decimal

  • 接口名稱:獲取合約歷史委託
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_hisorders

7、修改組合查詢合約歷史委託接口(返參orders中新增real_profit字段,表示真實收益,類型decimal

  • 接口名稱:組合查詢合約歷史委託
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_hisorders_exact

8、修改獲取歷史成交記錄接口(返參trades中新增real_profit字段,表示真實收益,類型decimal

  • 接口名稱:獲取歷史成交記錄
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_matchresults

9、修改組合查詢歷史成交記錄接口(返參trades中新增real_profit字段,表示真實收益,類型decimal

  • 接口名稱:組合查詢歷史成交記錄
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_matchresults_exact

10、修改訂閱訂單成交數據接口(返參外層新增real_profit字段,表示真實收益,類型decimal.返參trade中新增:real_profit字段,表示真實收益、profit字段,表示平倉盈虧。)

  • 接口名稱:訂閱訂單成交數據
  • 接口類型:私有接口
  • 訂閱地址:orders.$symbol

11、修改計劃委託全部撤單接口(請求參數新增 2 個選填字段:direction,表示買賣方向,不填默認撤銷全部。參數可選值為“buy”:買,“sell”:賣。offset,表示開平方向,不填默認撤銷全部。參數可 選值為“open”:開倉,“close”:平倉。)

  • 接口名稱:計劃委託全部撤單
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_trigger_cancelall

12、修改止盈止損訂單全部撤單接口(請求參數新增選填字段:direction,表示買賣方向,不填默認撤銷全部。參數可選值為“buy”:買,“sell”:賣。)

  • 接口名稱:止盈止損訂單全部撤單
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_tpsl_cancelall

13、修改查詢計劃委託當前委託接口(請求參數新增選填字段:trade_type,表示交易類型,不填默認查詢全部。參數可選值為 0:全部,1:買入開多,2: 賣出開空,3: 買入平空,4: 賣出平多。)

  • 接口名稱:查詢計劃委託當前委託
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_trigger_openorders

14、修改查詢止盈止損訂單當前委託接口(請求參數新增選填字段:trade_type,表示交易類型,不填默認查詢全部。參數可選值為 0:全部,3: 買入平空,4: 賣出平多。)

  • 接口名稱:查詢止盈止損訂單當前委託
  • 接口類型:私有接口
  • 接口URL:/api/v1/contract_tpsl_openorders

 

 

1.2.2 20210112 1 新增獲取預估結算價。2-7 新增止盈止損API接口,8-23 修改接口,新增字段。新增【合約策略訂單】一級菜單,將本次新增的雙向止盈止損相關接口以及原有的計劃委託相關接口挪到該菜單下】

1、新增獲取預估結算價

  • 接口名稱: 獲取預估結算價
  • 接口類型: 公共接口
  • 接口URL: /api/v1/contract_estimated_settlement_price

2、新增對倉位設置止盈止損訂單

  • 接口名稱: 對倉位設置止盈止損訂單
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_tpsl_order

3、新增止盈止損訂單撤單接口

  • 接口名稱: 止盈止損訂單撤單
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_tpsl_cancel

4、新增止盈止損訂單全部撤單接口

  • 接口名稱: 止盈止損訂單全部撤單
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_tpsl_cancelall

5、新增查詢止盈止損訂單當前委託接口

  • 接口名稱: 查詢止盈止損訂單當前委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_tpsl_openorders

6、新增查詢止盈止損訂單歷史委託接口

  • 接口名稱: 查詢止盈止損訂單歷史委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_tpsl_hisorders

7、新增查詢開倉單關聯的止盈止損訂單詳情接口

  • 接口名稱: 查詢開倉單關聯的止盈止損訂單詳情
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_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: /api/v1/contract_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: /api/v1/contract_batchorder

10、修改獲取合約訂單信息接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 獲取合約訂單信息
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_order_info

11、修改獲取訂單明細信息接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 獲取訂單明細信息
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_order_detail

12、修改獲取合約當前未成交委託接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 獲取合約當前未成交委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_openorders

13、修改獲取合約歷史委託接口(新增入參:sort_by(表示:排序字段,可選值為“create_date”“update_time”)。新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),update_time(表示:訂單的更新時間),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 獲取合約歷史委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_hisorders

14、修改組合查詢合約歷史委託接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 組合查詢合約歷史委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_hisorders_exact

15、修改訂閱訂單成交數據接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 訂閱訂單成交數據
  • 接口類型: 私有接口
  • 訂閱主題: orders.$symbol

16、修改訂閱訂單撮合數據接口(新增返回參數:is_tpsl(表示是否設置止盈止損,1:是;0:否),在返回參數order_source訂單來源新增枚舉值(tpsl:止盈止損觸發))

  • 接口名稱: 訂閱訂單撮合數據
  • 接口類型: 私有接口
  • 訂閱主題: matchOrders.$symbol

17、修改獲取計劃委託歷史委託接口(新增入參:sort_by(表示:排序字段,可選值為“created_at”“update_time”)。新增返回參數:update_time(表示:訂單的更新時間))

  • 接口名稱: 獲取計劃委託歷史委託
  • 接口類型: 私有接口
  • 接口URL: /api/v1/contract_trigger_hisorders

18、修改查詢K線數據(支持查詢已下市四周內的合約的K線數據(即到期日在過去最近四周的合約),可輸入已下市四周內的合約的合約代碼進行查詢K線數據。)

  • 接口名稱: 查詢K線數據
  • 接口類型: 公共接口
  • 接口URL: market/history/kline

19、修改請求K線數據(支持查詢已下市四周內的合約的K線數據(即到期日在過去最近四周的合約),可輸入已下市四周內的合約的合約代碼進行查詢K線數據。)

  • 接口名稱: 請求K線數據
  • 接口類型: 公共接口
  • 訂閱主題: market.$symbol.kline.$period

20、修改獲取當前可用合約總持倉量(在返回參數data中新增trade_volume:最近24小時成交量(張),trade_amount:最近24小時成交量(幣),trade_turnover:最近24小時成交額。這三個字段

  • 接口名稱: 獲取當前可用合約總持倉量
  • 接口類型: 公共接口
  • 接口URL: /api/v1/contract_open_interest

21、修改訂閱Market Detail數據(在返參tick中新增ask表示賣一,bid表示買一。)

  • 接口名稱: 訂閱Market Detail數據
  • 接口類型: 公共接口
  • 訂閱主題: market.$symbol.detail

22、修改獲取合約信息接口(新增返回參數:settlement_time(表示下次結算時間(毫秒時間戳)),delivery_time(表示交割時間(毫秒時間戳)))

  • 接口名稱: 獲取合約信息
  • 接口類型: 公共接口
  • 接口URL: /api/v1/contract_contract_info

23、修改訂閱合約信息變動(新增返回參數:settlement_time(表示下次結算時間(毫秒時間戳)),delivery_time(表示交割時間(毫秒時間戳)))

  • 接口名稱: 訂閱合約信息變動
  • 接口類型: 公共接口
  • 訂閱主題: public.$symbol.contract_info

 

 

 

1.2.1 2020年12月2日 【修改獲取訂單明細信息接口(查詢無成交撤單數據時,如果不傳“created_at”和“order_type”參數,由原來的只能查詢到最近12小時資料,改為只能查詢到最近2小時資料);修改獲取合約歷史委託接口(查詢無成交撤單數據時,由原來的只保留最近24小時資料,改為只保留最近2小時資料。);修改組合查詢合約歷史委託接口(查詢無成交撤單數據時,由原來的只保留最近24小時資料,改為只保留最近2小時資料。)】

1、修改獲取訂單明細信息接口(查詢無成交撤單數據時,如果不傳“created_at”和“order_type”參數,由原來的只能查詢到最近12小時資料,改為只能查詢到最近2小時資料)

  • 接口名稱:獲取訂單明細信息
  • 接口類型:私有接口
  • 接口URL:api/v1/contract_order_detail

 

2、修改獲取合約歷史委託接口(查詢無成交撤單數據時,由原來的只保留最近24小時資料,改為只保留最近2小時資料。)

  • 接口名稱:獲取合約歷史委託
  • 接口類型:私有接口
  • 接口URL:api/v1/contract_hisorders

3、修改組合查詢合約歷史委託接口(查詢無成交撤單數據時,由原來的只保留最近24小時資料,改為只保留最近2小時資料。)

  • 接口名稱:組合查詢合約歷史委託
  • 接口類型:私有接口
  • 接口URL:api/v1/contract_hisorders_exact

 

 

1.2.0 2020年11月24日 【新增:查詢平臺歷史結算記錄;修改:獲取強平訂單接口新增返參字段,訂閱強平訂單資料接口新增返參字段】

1、新增查詢平臺歷史結算記錄接口

  • 接口名稱:查詢平臺歷史結算記錄
  • 接口類型:公共接口
  • 接口URL:api/v1/contract_settlement_records

2、獲取強平訂單接口新增返參字段(返回參數中的 orders 參數下增加 amount 字段,表示強平數量(幣))

  • 接口名稱:獲取強平訂單接口
  • 接口類型:公共接口
  • 接口URL:api/v1/contract_liquidation_orders

3、訂閱強平訂單資料接口新增返參字段(返回參數中的data參數下增加amount字段,表示強平數量(幣))

  • 接口名稱:訂閱強平訂單資料
  • 接口類型:公共接口
  • 訂閱主題:public.$symbol.liquidation_orders

 

 

1.1.9 20201028日【新增:組合查詢合約歷史成交記錄接口、組合查詢合約歷史委託接口、組合查詢財務記錄接口】

1、新增組合查詢合約歷史成交記錄接口

  • 接口名稱:組合查詢合約歷史成交記錄
  • 接口類別型:私有接口
  • 接口地址:api/v1/contract_matchresults_exact

2、新增組合查詢合約歷史委託接口

  • 接口名稱:組合查詢合約歷史委託
  • 接口類別型:私有接口
  • 接口地址:api/v1/contract_hisorders_exact

3、新增組合查詢財務記錄接口

  • 接口名稱:組合查詢財務記錄
  • 接口類別型:私有接口
  • 接口地址:api/v1/contract_financial_record_exact

 

 

1.1.8 2020年10月15日 【新增:切換倍數接口;修改:切換倍數成功時 WS 資產接口推送更新資訊,切換倍數成功時 WS 持倉接口推送更新資訊,訂單撮合推送接口新增返參欄位,獲取合約訂單資訊接口(將原支援查詢 24 小時的撤單數據改為支援查詢 4 小時撤單數據)】

1、新增切換倍數接口

  • 接口名稱:切換倍數
  • 接口類型:私有接口
  • 接口位址:api/v1/contract_switch_lever_rate

2、訂閱資產接口推送更新(返參event新增事件類型,switch_lever_rate表示切換倍數。在用戶切換倍數成功時,需推送一次最新的資產資訊,event為switch_lever_rate。)

  • 接口名稱:訂閱資產變動數據
  • 接口類型:私有接口
  • 訂閱主題:$symbol

3、訂閱持倉接口推送更新(返參event新增事件類型,switch_lever_rate表示切換倍數。在用戶切換倍數成功時,需推送一次最新的持倉資訊(若使用者持倉量為0,則不會觸發推送),event為switch_lever_rate。)

  • 接口名稱:訂閱持倉變動數據
  • 接口類型:私有接口
  • 訂閱主題:$symbol

4、訂閱訂單撮合推送接口更新(返回參數新增以下欄位:direction(買賣方向)、offset (開平方向)、lever_rate(倍數)、price(委託價格)、created_at(創建時間)、order_source (訂單來源)、order_price_type(訂單報價類型)。)

  • 接口名稱:訂閱訂單撮合推送
  • 接口類型:私有接口
  • 訂閱主題:$symbol

5、獲取合約訂單資訊接口(將原支援查詢 24 小時的撤單數據改為支援查詢 4 小時撤單數據)

  • 接口名稱:獲取合約訂單資訊
  • 接口類型:私有接口
  • 接口位址:api/v1/contract_order_info

 

 

1.1.7 20201010日【新增:訂閱系統狀態更新推送的WebSocket接口

1、新增訂閱系統狀態更新推送的 WebSocket 接口

  • 介面名稱:訂閱系統狀態更新
  • 介面類型: 公共接口
  • 訂閱主題:public.$service.heartbeat

 

1.1.6 2020922 【新增:市場行情接口已支援按照合約code調用,包括restws接口。請求參數的“symbol”欄位中,新增合約code類型,格式固定為品種,比如:BTC200925;通過合約code調用暫時只支持查詢當前上市中的合約。】

1、獲取行情深度數據

  • 接口名稱:獲取行情深度數據
  • 接口類別型: 公共接口
  • 接口URL:/market/depth

2、獲取K線數據

  • 接口名稱:獲取K線數據
  • 接口類別型: 公共接口
  • 接口URL:/market/history/kline

3、獲取聚合行情

  • 接口名稱:獲取聚合行情
  • 接口類別型: 公共接口
  • 接口URL:/market/detail/merged

4、獲取市場最近成交記錄

  • 接口名稱:獲取市場最近成交記錄
  • 接口類別型: 公共接口
  • 接口URL:/market/trade

5、批量獲取最近的交易記錄

  • 接口名稱:批量獲取最近的交易記錄
  • 接口類別型: 公共接口
  • 接口URL:/market/history/trade

6、訂閱 KLine 數據

  • 接口名稱:訂閱 KLine 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.kline.$period

7、請求 KLine 數據

  • 接口名稱:請求 KLine 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.kline.$period

8、訂閱 Market Depth 數據

  • 接口名稱:訂閱 Market Depth 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.depth.$type

9、訂閱 Market Detail 數據

  • 接口名稱:訂閱 Market Detail 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.detail

10、訂閱 Trade Detail 數據

  • 接口名稱:訂閱 Trade Detail 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.trade.detail

11、請求 Trade Detail 數據

  • 接口名稱:請求 Trade Detail 數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.trade.detail

12、訂閱 Market Depth 增量數據

  • 接口名稱:訂閱 Market Depth 增量數據
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.depth.size_${size}.high_freq

13、訂閱買一賣一逐筆行情推送

  • 接口名稱:訂閱買一賣一逐筆行情推送
  • 接口類別型: 公共接口
  • 訂閱主題:$symbol.bbo

 

 

1.1.5 202086日【新增:查詢用戶結算記錄接口;訂閱計畫委託訂單更新接口】

1新增查詢用戶結算記錄接口

  • 接口名稱:查詢用戶結算記錄
  • 接口類別型:私有接口
  • 接口地址:api/v1/contract_user_settlement_records

2、訂閱計畫委託訂單更新

  • 接口名稱:訂閱計畫委託訂單更新
  • 接口類別型:私有接口
  • 訂閱主題:trigger_order.$symbol

 

1.14 2020年6月19日【訂閱訂單撮合數據接口推送結果新增client_order_id字段】

1、訂閱訂單撮合數據接口推送結果新增client_order_id字段

  • 接口名稱:訂閱訂單撮合數據
  • 接口類別型: 私有接口
  • 訂閱主題:matchOrders.$symbol

 

1.1.3 2020614日上線 【增加合約信息變動 WS 接口; 增加買一賣一逐筆行情 WS 接口; 訂閱 Market Depth 接口新增 4 個深度類型可選值; 新增查詢用戶可用杠杆倍數; 資產變動與持倉變動 WS 接口新增定期推送; 下單接口支援高倍杠杆; 優化查詢訂單相關接口的返回參數; 私有推送接口新增 uid 返回參數;訂單撮合推送接口新增欄位;合約類型參數新增次季度合約】

1、增加合約信息變動ws推送接口

  • 接口名稱:增加合約信息變動ws推送接口
  • 接口類別型:公開接口
  • 訂閱主題:public.$symbol.contract_info

2、增加買一賣一逐筆行情 WS 接口

  • 接口名稱:訂閱買一賣一逐筆行情推送
  • 接口類別型:公開接口
  • 訂閱主題:market.$symbol.bbo

3、訂閱 Market Depth 接口新增 4 個深度類型可選值:step12step13step14step15

  • 接口名稱:訂閱 Market Depth 數據
  • 接口類別型:公開接口
  • 訂閱主題:market.$symbol.depth.$type

4、新增查詢用戶可用杠杆倍數

  • 接口名稱:查詢用戶可用杠杆倍數
  • 接口類別型:私有
  • 接口位址:api/v1/contract_available_level_rate

5、資產變動WS 接口新增定期推送: 5秒一次定期推送

  • 接口名稱:訂閱資產變動數據
  • 接口類別型:私有接口
  • 訂閱主題: accounts.$symbol

6、倉位元變動WS 接口新增定期推送: 5秒一次定期推送

  • 接口名稱:訂閱持倉變動數據
  • 接口類別型:私有接口
  • 訂閱主題:positions.$symbol

7、下單接口支援高倍杠杆

  • 接口名稱:合約下單
  • 接口類別型:私有接口
  • 接口位址:api/v1/contract_order
  • 接口名稱:合約批量下單
  • 接口類別型:私有接口
  • 接口位址:api/v1/contract_batchorder
  • 接口名稱:合約計畫委託下單
  • 接口類別型:私有接口
  • 接口位址:api/v1/contract_trigger_order

8、獲取訂單明細信息接口返回參數,增加9個欄位:fee(總手續費)、order_id(訂單id)、order_id_strstring格式的訂單id)、client_order_id(客戶訂單id)、order_type(訂單類型)、status(訂單狀態)、trade_avg_price(成交均價)、trade_turnover(成交總金額)、trade_volume(成交總數量)

  • 接口名稱:獲取訂單明細信息
  • 接口類別型:私有接口
  • 接口位址:api/v1/contract_order_detail

9、獲取訂單信息接口返回參數,增加2個欄位:liquidation_type(強平類型)、 canceled_at(撤單時間)

  • 接口名稱:獲取訂單信息接口
  • 接口類別型:私有接口
  • 接口位址:api/v1/contract_order_info

10、訂閱成交訂單推送,增加2個欄位:canceled_at(撤單時間)、fee_asset (手續費幣種)

  • 接口名稱:訂閱成交訂單推送
  • 接口類別型:私有接口
  • 訂閱主題:orders.$symbol

11、私有推送接口新增 uid 返回參數

  • 接口名稱:訂閱成交訂單推送
  • 接口類別型:私有接口
  • 訂閱主題:orders.$symbol
  • 接口名稱:訂閱資產變動推送
  • 接口類別型:私有接口
  • 訂閱主題:accounts.$symbol
  • 接口名稱:訂閱持倉變動推送
  • 接口類別型:私有接口
  • 訂閱主題:positions.$symbol
  • 接口名稱:訂閱訂單撮合推送
  • 接口類別型:私有接口
  • 訂閱主題:matchOrders.$symbol

12、訂單撮合推送新增接口新增欄位,在返回參數的外層新增兩個欄位:trade_volume(訂單已成交數量) volume(訂單總委託數量)

  • 接口名稱:訂閱訂單撮合推送
  • 接口類別型:私有接口
  • 訂閱主題:matchOrders.$symbol

13、合約類型參數新增次季度合約,合約類型(contract_type)參數新增次季度合約可選值

  • 接口名稱:行情市場、資產以及交易(restful及websocket)接口
  • 接口類別型: 公開/私有

 

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】

nodejsJavascript的用戶請特別注意:order_id返回是18位,nodejsjavascript默認解析18位有問題,nodejsjavascript裡面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。具體使用方式是用match_id和id作為聯合主鍵,拼接成unique的成交ID。
  1. 修改下單
  • rest接口api/v1/contract_order和批量下單
  • rest接口api/v1/contract_batchorder
  • 請求參數order_price_type中增加訂單價格類型“fok”;
  1. 修改查詢用戶當前的下單量限制
  • rest接口api/v1/contract_order_limit返回參數的“ order_price_type”,表示訂單報價類型,
  • 增加"fok":FOK訂單
  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限頻
  • 私有接口限頻由原來的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日上線