關於火幣幣本位永續和交割合約API接入文檔的說明

尊敬的用戶：

歡迎有優秀 maker 策略交易量大的用戶參與長期合約做市商項目。如果您的火幣幣本位交割合約帳戶中有折合大於 3 BTC 資產，或火幣幣本位永續合約帳戶中有折合大於 3 BTC 資產，請提供以下信息到 [email protected]（做市商項目不支持點卡抵扣、VIP、交易量相關活動以及任何形式的返傭活動）:

• 提供火幣UID（需不存在返傭關係的UID）
• 提供其他交易平台證明maker交易量截圖（比如30天內成交量，或者VIP等級等）

如果您是其他平臺的VIP用戶，您也可以通過我們的VIP共享計畫申請費率優惠。申請細節，請點解>>>

成為火幣合約做市商，您將享受如下權益:

• 費率優惠，maker負費率
• API限頻提升
• 持倉限制提升
• 新加入做市商首個自然月免考核
• 自動開通合約子賬號功能（查看更多關於合約子賬號信息>>>）
• Colocation服務

示例：

某做市商3月份中某一天成功申請成為火幣合約做市商，即日起，即可享受相對應的費率優惠、API限頻提升，持倉限制提升，我司將從4月1日起再對其進行maker交易量考核。具體考核標準：

幣本位交割合約做市商考核標準>>>

幣本位永續合約做市商考核標準>>>

溫馨提示：

• 負費率指無需收取其交易手續費，且實时返還其該筆交易手續費
• 如費率或費率適用時段有調整，請以最新官方公告為准

目前已搭建火幣合約API交流群，歡迎用戶進群交流，請添加官方微信號(dm59488，dm19985)，並備注“進API群”。

API用戶，請關注如下連結：

【合約交易網站地址】

https://www.huobi.bi/zh-cn/；https://www.btcgateway.pro

【API訪問地址】

https://api.hbdm.com

中國大陸推薦使用：https://api.btcgateway.pro

【火币幣本位合約API版本历史记录】https://huobiglobal.zendesk.com/hc/zh-cn/articles/360000263201

【火幣合約帮助中心】https://huobiglobal.zendesk.com/hc/zh-cn/categories/360000032161

幣本位交割合约：

【API文档地址】https://docs.huobigroup.com/docs/dm/v1/cn/

【Rust 異步庫地址】https://github.com/hbdmapi/huobi_future_async

【Python DEMO地址】https://github.com/huobiapi/Futures-Python-demo

【Java DEMO地址】https://github.com/huobiapi/Futures-Java-demo

【NodeJS DEMO地址】https://github.com/huobiapi/Futures-Node.js-demo

【PHP DEMO地址】https://github.com/huobiapi/Futures-PHP-demo

【C# DEMO地址】https://github.com/huobiapi/Futures-CSharp-demo

【GO DEMO地址】https://github.com/huobiapi/Futures-Go-demo

【Postman DEMO地址】https://github.com/hbdmapi/huobi_futures_Postman

幣本位永續合約：

【API文档地址】https://docs.huobigroup.com/docs/coin_margined_swap/v1/cn/

【Python DEMO地址】https://github.com/hbdmapi/hbdm_Python

【Java DEMO地址】https://github.com/hbdmapi/java_demo

【Rust DEMO地址】https://github.com/hbdmapi/hbdm_swap_Rust

【C++ DEMO地址】 https://github.com/hbdmapi/huobi_swap_Cpp

【Postman DEMO地址】https://github.com/hbdmapi/huobi_futures_Postman

備註：永續代碼使用方式與交割合約類似，其他語言demo可以參考交割合約。

完整API示例：

• 獲取火幣幣本位交割合約信息：https://api.hbdm.com/api/v1/contract_contract_info
• 獲取火幣幣本位交割合約最高限價和最低限價：https://api.hbdm.com/api/v1/contract_price_limit?symbol=BTC&contract_type=this_week
• 獲取火幣幣本位永續合約的歷史資金費率：https://api.hbdm.com/swap-api/v1/swap_historical_funding_rate?contract_code=btc-usd&page_index=1&page_size=50
• 獲取火幣幣本位永續合約的K線數據：https://api.hbdm.com/swap-ex/market/history/kline?contract_code=BTC-USD&period=1day&size=50
• 以上僅供示例用途 

幣本位交割合約訪問次數限制：

• 幣本位交割合約和幣本位永續合約分開限頻。
•  
• 公開行情接口和用戶私有接口都有訪問次數限制
•  
• 普通用戶，需要金鑰的私有接口，每個UID 3秒最多72次請求(交易接口3秒最多36次請求，查詢接口3秒最多36次請求) (該UID的所有幣種和不同到期日的合約的所有私有接口共用該限制) 查看API接口類別型列表(其中讀取即查詢,交易即交易)
•  
• 其他非行情類的公開接口，比如獲取指數信息，限價信息，交割結算、平臺持倉信息等，所有用戶都是每個IP3秒最多120次請求（所有該IP的非行情類的公開接口請求共用3秒120次的額度）
•  
• 行情類的公開接口，比如：獲取K線資料、獲取聚合行情、市場行情、獲取市場最近成交記錄：（1） restful接口：同一個IP, 1秒最多800個請求
  （2） websocket：req請求，同一時刻最多請求50次；sub請求，無限制，伺服器主動推送資料
•  
• WebSocket私有訂單成交推送接口(需要API KEY驗簽)

• 一個UID最多同時建立10個私有訂單成交推送WS連結。該用戶在一個品種(包含該品種的所有週期的合約)上，僅需要維持一個訂單推送WS連結即可。

  注意: 訂單推送WS的限頻，跟用戶RESTFUL私有接口的限頻是分開的，相互不影響。

• 查詢與交易API接口返回的header中會有限頻資訊。比如：查詢訂單資訊接口(/api/v1/contract_order_info)，返回的header中的ratelimit-limit即查詢接口的總限制頻率次數，ratelimit-remaining即查詢接口的剩餘總限制頻率次數。下單接口(/api/v1/contract_order)，返回的header中的ratelimit-limit即交易接口的總限制頻率次數，ratelimit-remaining即交易接口的剩餘總限制頻率次數。查看API接口類別型列表(其中讀取即查詢,交易即交易)

• 將在api接口response中的header返回以下欄位：
  ratelimit-limit： 單輪請求數上限，單位：次數
  ratelimit-interval：請求數重置的時間間隔，單位：毫秒
  ratelimit-remaining：本輪剩餘可用請求數，單位：次數
  ratelimit-reset：請求數上限重置時間，單位：毫秒

• 如果觸發了撤單率限制，您的api介面response返回header中會包括欄位：
  recovery-time：禁用的恢復時間戳記，單位為毫秒，表示禁用結束時間，可恢復訪問的時間戳記；
  如果不在禁用期間，header不返回recovery-time欄位；

• 一個uid對應計畫委託下單接口請求1秒5次、一個uid對應計畫委託撤單接口請求1秒5次、一個uid對應計畫委託全部撤單接口請求1秒5次。

幣本位永續合約訪問次數限制：

• 交割合約、幣本位永續合約、期權合約和USDT本位永續合約都分開限頻
• 公開行情接口和用戶私有接口都有訪問次數限制
• 普通用戶，需要密鑰的私有接口，每個UID 3秒最多 72 次請求(交易接口3秒最多 36 次請求，查詢接口3秒最多 36 次請求) (該UID的所有幣種和不同到期日的合約的所有私有接口共享該限制)。 查看API接口類型列表(其中讀取即查詢,交易即交易)
• 其他非行情類的公開接口，比如獲取指數信息，限價信息，交割結算、平臺持倉信息等，所有用戶都是每個IP3秒最多120次請求（所有該IP的非行情類的公開接口請求共享3秒120次的額度）
• 行情類的公開接口，比如：獲取K線數據、獲取聚合行情、市場行情、獲取行情深度數據、獲取溢價指數K線、獲取實時預測資金費率k線，獲取基差數據、獲取市場最近成交記錄：
  （1） restful接口：同一個IP, 所有業務（交割合約、幣本位永續合約、期權合約和USDT本位永續合約）總共1秒最多800個請求
  （2） websocket：req請求，同一時刻最多請求50次；sub請求，無限制，服務器主動推送數據
• WebSocket私有訂單成交推送接口(需要API KEY驗簽)一個UID最多同時建立30個私有訂單成交推送WS鏈接。該用戶在一個品種(包含該品種的所有週期的合約)上，僅需要維持一個訂單推送WS鏈接即可。
  注意: 訂單推送WS的限頻，跟用戶RESTFUL私有接口的限頻是分開的，相互不影響。
• 查詢與交易API接口返回的header中會有限頻信息。比如：查詢訂單信息接口(/swap-api/v1/swap_account_info)，返回的header中的ratelimit-limit即查詢接口的總限制頻率次數，ratelimit-remaining即查詢接口的剩餘總限制頻率次數。下單接口(/swap-api/v1/swap_order)，返回的header中的ratelimit-limit即交易接口的總限制頻率次數，ratelimit-remaining即交易接口的剩餘總限制頻率次數。查看API接口類型列表(其中讀取即查詢,交易即交易)
• 所有API接口返回數據中增加限頻信息
  

  將在api接口response中的header返回以下字段：

  ratelimit-limit： 單輪請求數上限，單位：次數

  ratelimit-interval：請求數重置的時間間隔，單位：毫秒

  ratelimit-remaining：本輪剩餘可用請求數，單位：次數

  ratelimit-reset：請求數上限重置時間，單位：毫秒

  如果觸發了撤單率限制，您的api接口response返回header中會包括字段：

  recovery-time：禁用的恢復時間戳，單位為毫秒，表示禁用結束時間，可恢復訪問的時間戳；

  如果不在禁用期間，header不返回recovery-time字段；

• 一個uid對應計劃委託下單接口請求1秒5次、一個uid對應計劃委託撤單接口請求1秒5次、一個uid對應計劃委託全部撤單接口請求1秒5次。

欢迎关注火币合约社群
官方微信号：dm20203
官方QQ群：1083210627
Telegram：https://t.me/huobidmofficial
【火币合约官方验证通道请点击>>>】