【期权合约指引】期权合约API接入文档说明

尊敬的用户：

欢迎您参与火币期权做市商项目，如果您的火币期权合约账户中有折合大于 3 BTC 资产，请提供以下信息至dm_mm@huobi.com：

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

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

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

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

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

提示：
1.期权交易手续费不超过权利金的12.5%，行权交割手续费不超过行权收入的12.5%，maker返佣比例不超过权利金的8%。
2. 原交割合约和永续合约的做市商可以直接享受同等级的做市商待遇；
3. Colocation与交割合约和永续合约产品共用；
4. 以上费率及其他优惠条件的数值、申请条件和适用阶段，都有可能变更。如有更新，以官方公告为准。

示例：

某做市商3月份中某一天成功申请成为火币合约做市商，即日起，即可享受相对应的费率优惠、API限频提升，持仓限制提升，我司将从4月1日起再对其进行maker交易量考核。具体考核标准：

期权合约做市商考核标准>>>

目前已搭建火币合约API交流群，欢迎用户进群交流，请添加官方微信号(dm19985，dm59488)，并备注“进API群”。

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

【合约交易网站地址】

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

【API访问地址】

https://api.hbdm.com

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

【期权合约帮助中心】https://support.hbfile.net/hc/zh-cn/sections/900000256146

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

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

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

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

备注：期权代码使用方式与币本位交割和币本位永续合约类似，其他语言demo可以参考币本位交割和币本位永续合约。

期权合约完整API示例：

获取火币期权信息：https://api.hbdm.com/option-api/v1/option_contract_info?contract_code=BTC-USDT-200925-C-10000 获取火币期权最高限价和最低限价：https://api.hbdm.com/option-api/v1/option_price_limit?contract_code=BTC-USDT-200925-C-10000 以上仅供示例用途

期权合约访问次数限制：

交割合约、币本位永续合约、期权合约和USDT本位永续合约都分开限频 公开行情接口和用户私有接口都有访问次数限制 普通用户，需要密钥的私有接口，每个UID 3秒最多 48 次请求(交易接口3秒最多 24 次请求，查询接口3秒最多 24 次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制) 。查看API接口类型列表(其中读取即查询,交易即交易) 其他非行情类的公开接口，比如获取指数信息，限价信息，交割结算、平台持仓信息等，所有用户都是每个IP3秒最多60次请求（所有该IP的非行情类的公开接口请求共享3秒60次的额度） 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取市场最近成交记录：

（1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约、期权合约和USDT本位永续合约）总共1秒最多800个请求

（2） websocket：req请求，同一时刻最多请求50次；sub请求，无限制，服务器主动推送数据

WebSocket私有订单成交推送接口(需要API KEY验签)

一个UID最多同时建立30个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上，仅需要维持一个订单推送WS链接即可。

注意: 订单推送WS的限频，跟用户RESTFUL私有接口的限频是分开的，相互不影响。

查询与交易API接口返回的header中会有限频信息。比如：查询订单信息接口(/option-api/v1/option_account_info)，返回的header中的ratelimit-limit即查询接口的总限制频率次数，ratelimit-remaining即查询接口的剩余总限制频率次数。下单接口(/option-api/v1/option_order)，返回的header中的ratelimit-limit即交易接口的总限制频率次数，ratelimit-remaining即交易接口的剩余总限制频率次数。 查看API接口类型列表(其中读取即查询,交易即交易) 所有API接口返回数据中增加限频信息

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

ratelimit-limit： 单轮请求数上限，单位：次数

ratelimit-interval：请求数重置的时间间隔，单位：毫秒

ratelimit-remaining：本轮剩余可用请求数，单位：次数

ratelimit-reset：请求数上限重置时间，单位：毫秒

一个uid对应计划委托下单接口请求1秒5次、一个uid对应计划委托撤单接口请求1秒5次、一个uid对应计划委托全部撤单接口请求1秒5次。

欢迎关注火币合约社群
官方微信号：dm19103
官方QQ群：1083210627
Telegram：https://t.me/huobidmofficial
【】