htx api接入需完成实名认证并获取api key、secret key与passphrase三元组；配置hmac-sha256签名机制，设置access-sign与access-timestamp请求头；绑定ip白名单以限制调用来源；公共rest接口可直接获取行情数据；websocket连接需先auth认证再订阅行情。
火币htx官方认证入口：
火币官方APP下载链接：
一、获取HTX API访问权限
需在HTX官网开发者中心完成实名认证并创建API应用，系统将分配唯一的API Key、Secret Key与Passphrase。该三元组是后续所有签名请求的身份凭证，必须严格保密。
1、访问HTX官网，进入“开发者中心”页面。
2、使用已通过KYC认证的主账号登录。
3、点击“创建API密钥”，填写应用名称与回调地址（如无需回调可留空）。
4、勾选所需权限范围：只读权限用于行情查询，交易权限需额外开启二次验证。
5、确认生成后，立即下载并安全存储Secret Key与Passphrase——页面关闭后Secret Key将不可再次查看。
二、配置请求签名机制
HTX API采用HMAC-SHA256算法对请求参数进行签名，签名值需置于HTTP Header的ACCESS-SIGN字段。时间戳（ACCESS-TIMESTAMP）与密钥派生过程共同构成防重放校验基础。
1、构造原始签名字符串：拼接timestamp（毫秒级UTC时间）+ method（大写）+ requestPath + queryString（如有）+ body（如有且为JSON）。
2、使用Secret Key对原始字符串执行HMAC-SHA256运算，输出十六进制小写字符串。
3、将结果填入请求头：ACCESS-SIGN: 生成的十六进制签名串。
4、同步设置：ACCESS-TIMESTAMP: 当前毫秒级UTC时间戳，误差须控制在±5秒内。
三、设置IP白名单与权限隔离
为限制API调用来源并降低密钥泄露风险，HTX强制要求为每个API Key绑定可信IP地址列表。未授权IP发起的请求将被网关直接拒绝，不进入业务逻辑层。
1、在API密钥管理页找到对应Key，点击“编辑白名单”。
2、输入单个IPv4地址或CIDR网段（如192.168.1.0/24），支持最多20条记录。
3、保存后，新白名单10分钟内生效，期间旧IP仍可调用。
4、如需调试，可临时添加本地公网IP；生产环境应仅保留服务器出口IP。
四、调用REST接口获取市场数据
使用已签名的HTTP请求访问公共端点，无需认证即可获取实时行情、深度簿及K线数据。此类接口无频次限制但禁止高频轮询，触发限流将返回429状态码。
1、构造GET请求URL：https://api.htx.com/market/detail/merged?symbol=btcusdt。
2、在Header中添加：Content-Type: application/json。
3、发送请求，响应体为标准JSON格式，含price、ask、bid等字段。
4、解析响应时注意检查code字段是否为200，非200需按message内容定位异常类型。
五、接入WebSocket行情推送
HTX提供全量WebSocket行情通道，支持订阅多币对的ticker、depth和trade事件。连接建立后需先发送auth消息完成身份校验，否则30秒后自动断连。
1、建立WebSocket连接至：wss://api.htx.com/ws/v2。
2、连接成功后立即发送auth帧：{"action":"req","ch":"auth","params":{"accessKey":"xxx","signature":"yyy","timestamp":"zzz"}}。
3、收到{"action":"ack","ch":"auth","code":200}表示认证通过。
4、随后发送subscribe帧，例如：{"action":"sub","ch":"market.btcusdt.ticker"}。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
