U本位合约API接入文档说明

币本位交割合约、币本位永续合约和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次。

APP内打开

火币

数字资产交易平台

打开

U本位合约API接入文档说明

2021/03/09 09:24

U本位合约指引

尊敬的用户：

欢迎您参与USDT本位合约做市商项目，如果您的火币USDT本位合约全仓账户中有折合大于100,000 USDT 资产，请提供以下信息至[email protected]：

提供火币 UID（需不存在返佣关系的UID）
提供其他交易平台证明maker交易量截图（比如30天内成交量，或者VIP等级等）

注：做市商项目不支持点卡抵扣、VIP、交易量相关活动以及任何形式的返佣活动。

如果您是其他平台的合约VIP用户，您也可以通过我们的合约VIP共享计划申请费率优惠，申请细节，请点击>>>

成为火币USDT本位合约做市商，您将享受如下权益:

费率优惠，maker负费率
API限频提升
持仓限制提升
新加入做市商首个自然月免考核
自动开通合约子账号功能（查看更多关于合约子账号信息>>>）
Colocation服务

Taker费率调整详情请查看：HTX全平台Pro等级共享计划

示例：

USDT本位合约做市商考核标准>>>

API用户，请关注如下链接：

【合约交易网站地址】

https://futures.huobi.com；https://www.btcgateway.pro

【API访问地址】

https://api.hbdm.com

中国大陆推荐使用：https://api.btcgateway.pro

【合约帮助中心】https://www.huobi.com/support/zh-cn/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本位合约分开限频。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次。

2021/03/09 09:12

2021/03/09 09:05

2021/02/18 02:24

2020/12/24 02:59

2021/02/18 05:15

公告

搜索

U本位合约API接入文档说明