U本位合約API接入說明
- USDT 本位合約指南
尊敬的用戶:
歡迎您參與USDT本位合約做市商項目,如果您的火币USDT本位合約全倉帳戶中有折合大於100,000 USDT 資產,請提供以下資訊至[email protected]:
- 提供火币UID(需不存在返傭關係的UID)
- 提供其他交易平臺證明maker交易量截圖(比如30天內成交量,或者VIP等級等)
注:做市商項目不支持點卡抵扣、VIP、交易量相關活動以及任何形式的返傭活動。
如果您是其他平臺的合約VIP用戶,您也可以通過我們的合約VIP共用計畫申請費率優惠,申請細節,請點擊>>>
成為火币USDT本位合約做市商,您將享受如下權益:
- 費率優惠,maker負費率
- API限頻提升
- 持倉限制提升
- 新加入做市商首個自然月免考核
- 自動開通合約子帳號功能(查看更多關於合約子帳號資訊>>>)
- Colocation服務
Taker費率調整詳情請查看:HTX全平臺Pro等級共享計劃
示例:
某做市商3月份中某一天成功申請成為火币合約做市商,即日起,即可享受相對應的費率優惠、API限頻提升,持倉限制提升,我司將從4月1日起再對其進行maker交易量考核。具體考核標準:
API使用者,請關注如下連結:
【合約交易網站位址】
https://futures.huobi.com;https://www.btcgateway.pro
【API訪問位址】
中國大陸推薦使用:https://api.btcgateway.pro
【合約幫助中心】https://www.huobi.com/support/zh-hk/list/360000032161
【API文檔地址】https://docs.huobigroup.com/docs/usdt_swap/v1/cn/#api
【Java DEMO地址】https://github.com/hbdmapi/huobi_usdt_swap_Java
【Python DEMO地址】https://github.com/hbdmapi/hbdm_Python
【Postman DEMO地址】https://github.com/hbdmapi/huobi_futures_Postman
【CSharp DEMO地址】https://github.com/hbdmapi/huobi_futures_CSharp
【Golang DEMO地址】https://github.com/hbdmapi/huobi_futures_Golang
【C++ DEMO地址】https://github.com/hbdmapi/huobi_futures_Cpp
備註:USDT本位合約代碼使用方式與幣本位永續和幣本位交割合約類似,其他語言DEMO可以參考交割合約。
完整API示例:
獲取USDT本位合約市場最近成交記錄:https://api.hbdm.com/linear-swap-ex/market/trade?contract_code=BTC-USDT
獲取USDT本位合約行情深度資料:https://api.hbdm.com/linear-swap-ex/market/depth?contract_code=BTC-USDT&type=step0
訪問次數限制
- 幣本位交割合約、幣本位永續合約和USDT本位合約分開限頻。USDT本位合約包含USDT本位交割合約與USDT本位永續合約,兩者總享API限頻。
- 公開行情接口和用戶私有接口都有訪問次數限制
- 普通用戶,需要密鑰的私有接口,每個UID 3秒最多 144 次請求(交易接口3秒最多 72 次請求,查詢接口3秒最多 72 次請求) (該UID的所有幣種和不同到期日的合約的所有私有接口共享該限制) 。查看API接口類型列表(其中讀取即查詢,交易即交易)
- 其他非行情類的公開接口,比如獲取指數信息,限價信息,交割結算、平臺持倉信息等,所有用戶都是每個IP3秒最多240次請求(所有該IP的非行情類的公開接口請求共享3秒240次的額度)
- 行情類的公開接口,比如:獲取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中會有限頻信息。比如:查詢訂單信息接口(/linear-swap-api/v1/swap_account_info),返回的header中的ratelimit-limit即查詢接口的總限制頻率次數,ratelimit-remaining即查詢接口的剩餘總限制頻率次數。下單接口(/linear-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次。