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"}。