spot

HTX 现货技能

使用经过身份验证的 API 端点在 HTX 进行现货交易。某些端点需要 API 密钥和密钥。以 JSON 格式返回结果。

快速参考

参考数据端点

端点	说明	必填	可选	身份验证
GET /v2/market-status	返回当前市场状态及枚举值，包括：1=正常，2=暂停交易，3=仅允许撤单	无	无	否
GET /v2/settings/common/symbols	返回所有支持的交易品种及详细配置，包括状态、精度和交易状态	无	ts	否
GET /v2/settings/common/currencies	返回所有支持的币种及其配置和显示名称	无	ts	否
GET /v1/settings/common/symbols	返回包含价格和交易精度信息的交易品种设置	无	无	否
GET /v1/settings/common/market-symbols	返回现货交易的市场交易品种配置	无	无	否
GET /v2/reference/currencies	返回币种和区块链链的参考数据	无	无	否
GET /v1/common/timestamp	返回当前服务器时间戳（毫秒）	无	无	否

市场数据端点

端点	说明	必填	可选	身份验证
GET /market/history/klines	返回指定交易品种和时间段的 OHLC 蜡烛图数据	symbol、period	size、from	否
GET /market/detail	返回某个交易品种的最新市场行情数据，包括价格、交易量和 24 小时统计数据	symbol	无	否
GET /market/tickers	返回所有交易对的最新行情数据	无	无	否
GET /market/depth	返回某个交易品种的订单簿深度（买单和卖单）	symbol、type	无	否
GET /market/trade	返回某个交易品种的最新成交数据	symbol	无	否
GET /market/history/trade	返回某个交易品种的近期成交记录	symbol	size	否
GET /market/overview	返回所有交易品种的 24 小时市场摘要统计数据	无	无	否
GET /market/orderbook	返回某个交易品种的完整订单簿及全部深度	symbol	depth	否

账户端点

端点	说明	必填	可选	身份验证
GET /v1/account/accounts	返回经过身份验证的用户的所有账户详情	无	无	是
GET /v1/account/accounts/{account-id}/balance	返回指定账户的余额详情，包括资产和负债	account-id	无	是
GET /v2/account/valuation	返回用户投资组合中所有账户的总资产估值	无	valuationCurrency	是
GET /v2/account/asset-valuation	返回详细的资产估值和投资组合构成	无	无	是
POST /v1/account/transfer	在账户之间划转资产	from-account、to-account、currency、amount	无	是
GET /v1/account/history	返回账户历史记录和交易记录	无	account-id、currency、type	是
POST /v1/futures/transfer	在现货交易账户和期货合约账户之间划转资金	currency、amount、type	无	是
GET /v1/point/account	返回当前 HTX 积分余额和历史记录	无	无	是
POST /v1/point/transfer	在账户之间划转 HTX 积分	from-user、to-user、amount	无	是

交易接口

接口	描述	必填	可选	身份验证
POST /v1/order/orders/place	下达新的现货交易订单（限价或市价）	account-id、amount、symbol、type	price、client-order-id、source、time-in-force	是
POST /v1/order/orders/{order-id}/cancel	取消待处理订单	order-id	无	是
POST /v1/order/orders/batchcancel	取消符合指定条件的多个订单	无	account-id、symbol	是
GET /v1/order/orders/{order-id}	返回特定订单的详细信息	order-id	无	是
GET /v1/order/orders	返回符合指定条件（未完成、已完成、已取消）的订单	account-id	symbol、states、types、start-time、end-time、from、direct、size	是
GET /v1/order/orders/getClientOrder	使用 client-order-id 返回订单详细信息	client-order-id	无	是
GET /v1/order/matchresults	返回交易历史和成交详情	无	symbol、types、start-time、end-time、from、direct、size	是

保证金借贷（全仓／逐仓）接口

接口	描述	必填	可选	身份验证
POST /v1/margin/orders	为全仓或逐仓保证金账户申请保证金贷款	currency、amount	account-id	是
POST /v1/margin/orders/{order-id}/repay	偿还保证金贷款及利息	order-id、amount	无	是
GET /v1/margin/orders	返回保证金贷款订单及其状态	无	currency、state、from、size	是
GET /v1/margin/accounts/balance	返回保证金账户的详细余额信息	无	account-id	是

---

参数

通用参数

• symbol：交易对（例如 btcusdt、ethusdt）
• symbols：以逗号分隔的交易对列表
• account-id：账户 ID（可从 /v1/account/accounts 获取）
• type：订单类型
• amount：订单数量（买入市价单的数量以计价币种表示；其他订单以基础币种表示）
• price：订单价格（限价单必填）
• source：订单来源（默认值：spot-api）
• client-order-id：由客户端定义的订单 ID（最大长度：64）
• self-match-prevent：自成交防护（0=禁用，1=启用）
• stop-price：止损限价单的触发价格
• operator：止损订单的运算符（gte、lte）
• order-id：订单 ID
• period：K 线周期／间隔
• size：返回的记录数
• depth：深度级别（例如 step0、step1、step2 等）
• side：订单方向（买入、卖出）
• states：订单状态（以逗号分隔）
• types：订单类型（以逗号分隔）
• start-date：开始日期（格式：yyyy-mm-dd）
• end-date：结束日期（格式：yyyy-mm-dd）
• start-time：开始时间（Unix 毫秒时间戳）
• end-time：结束时间（Unix 毫秒时间戳）
• from：分页起始 ID
• direct：分页方向（prev、next）
• accountType：资产估值的账户类型
• valuationCurrency：估值币种（例如 BTC、USDT、CNY）
• transactTypes：交易类型（以逗号分隔）
• limit：返回的记录数
• fromId：查询起始 ID
• currency：币种名称（小写，例如 btc、usdt）
• show-desc：显示描述（true、false）
• ts：查询时间戳（可选）
• authorizedUser：授权用户标记（true、false）

枚举

• period：1min | 5min | 15min | 30min | 60min | 4hour | 1day | 1mon | 1week | 1year
• type (order)：buy-market | sell-market | buy-limit | sell-limit | buy-ioc | sell-ioc | buy-limit-maker | sell-limit-maker | buy-stop-limit | sell-stop-limit | buy-limit-fok | sell-limit-fok | buy-stop-limit-fok | sell-stop-limit-fok
• side：buy | sell
• states：submitted | partial-filled | partial-canceled | filled | canceled
• operator：gte | lte
• accountType：spot | margin | otc | point | super-margin | investment | borrow
• transactTypes：trade | etf | transact-fee | deduction | transfer | credit | liquidation | interest | deposit-withdraw | withdraw-fee | exchange | other-types
• depth (step)：step0 | step1 | step2 | step3 | step4 | step5

---

身份验证

对于需要身份验证的端点，你需要提供 HTX API 凭据。 所需凭据：

• apiKey：你的 HTX API 密钥（用于 AccessKeyId 参数）
• secretKey：你的 HTX API 密钥（用于签名）

基础 URL：

• 主网：https://api.huobi.pro
• 主网（AWS）：https://api-aws.huobi.pro

安全

分享凭据

用户可以发送一个文件来提供 HTX API 凭据，文件内容格式如下：

fe45419a...xyz
secretabc...key

切勿显示完整密钥

向用户显示凭据时：

• **API Key：**显示前 5 个字符和后 4 个字符：fe45419a...xyz
• **Secret Key：**始终遮盖，仅显示最后 5 个字符：***...key1

用户询问凭据时的回复示例：

Account: main
API Key: fe45419a...xyz
Secret: ***...key1
Environment: Mainnet

列出账户

列出账户时，仅显示名称和环境，切勿显示密钥：

HTX Accounts:
* main (Mainnet)
* trading (Mainnet - AWS)

主网交易

在主网执行交易时，继续操作前始终先向用户确认，要求用户输入“CONFIRM”。

---

HTX 账户

main

• API Key：your_mainnet_api_key
• Secret：your_mainnet_secret
• Environment：https://api.huobi.pro
• Description：主交易账户

trading

• API Key：your_aws_api_key
• Secret：your_aws_secret
• Environment：https://api-aws.huobi.pro
• Description：针对 AWS 优化的交易

TOOLS.md 结构

## HTX Accounts

### main
- API Key: fe45419a...xyz
- Secret: secretabc...key
- Environment: https://api.huobi.pro
- Description: Primary trading account

### trading
- API Key: test456...abc
- Secret: testsecret...xyz
- Environment: https://api-aws.huobi.pro
- Description: AWS optimized trading

Agent 行为

1. 请求凭据：遮盖密钥（仅显示最后 5 个字符）
2. 列出账户：显示名称和环境，切勿显示密钥
3. 选择账户：如有歧义则询问，默认使用 main
4. 在主网执行交易时，继续操作前先向用户确认，要求用户输入“CONFIRM”
5. 新凭据：提示用户提供名称和环境

添加新账户

用户提供新凭据时：

• 询问账户名称
• 询问：使用哪个环境（主网或主网-AWS）
• 将凭据存储在 TOOLS.md 中，并确认时遮盖显示

请求签名

所有经过身份验证的端点都需要 HMAC SHA256 签名：

1. 按以下顺序创建预签名字符串：
   • HTTP 方法（GET/POST）+ "\n"
   • API 主机（例如 api.huobi.pro）+ "\n"
   • API 路径（例如 /v1/order/orders）+ "\n"
   • 已排序的查询字符串参数
2. 在所有经过身份验证的请求中添加所需参数：
   • AccessKeyId：你的 API 密钥
   • SignatureMethod：HmacSHA256
   • SignatureVersion：2
   • Timestamp：UTC 时间戳，格式为 yyyy-MM-ddTHH:mm:ss
3. 使用 secretKey 通过 HMAC SHA256 对预签名字符串进行签名
4. 将签名作为 Signature 参数添加到查询字符串中
5. 对于 POST 请求，还需将签名包含在 URL 查询字符串中

预签名字符串示例：

POST\n
api.huobi.pro\n
/v1/order/orders/place\n
AccessKeyId=xxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15:19:30

User Agent 标头

包含 User-Agent 标头，值为：htx-spot/1.0.0 (Skill)

重要说明

• 所有时间戳均为 Unix 毫秒
• 交易对名称应使用小写（例如 btcusdt，而不是 BTCUSDT）
• 对于市价买单，amount 参数表示计价货币金额
• 对于所有其他订单类型，amount 表示基础货币金额
• 交易前必须通过 /v1/account/accounts 端点获取账户 ID
• 受速率限制约束，详情请参阅 HTX API 文档
• 每个经过身份验证的请求都必须计算签名
• 签名中的时间戳必须与服务器时间相差不超过 1 分钟
• 查询订单时，通过 API 创建的订单在取消超过 2 小时后将无法再查询
• 历史数据的最大查询时间范围通常为 48 小时，数据可查询最近 180 天
• 提交批量订单时，每批最多 10 个订单
• 费率查询每次最多支持 10 个交易对
• 所有请求端点都必须与文档中指定的端点一致。

API 文档

更多详情请参阅 HTX 官方 API 文档：https://www.htx.com/en-us/opend/newApiPages/