API接入：https://huobiglobal.zendesk.com/hc/zh-tw/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