HTX Spot Skill

Spot trading on HTX using authenticated API endpoints. Requires API key and secret key for certain endpoints. Return the result in JSON format.

Quick Reference

Reference Data Endpoints

Endpoint	Description	Required	Optional	Authentication
GET `/v2/market-status`	Returns current market status with enum values including: 1=normal, 2=halted, 3=cancel-only	None	None	No
GET `/v2/settings/common/symbols`	Returns all supported trading symbols with detailed configuration including state, precision, and trading status	None	ts	No
GET `/v2/settings/common/currencies`	Returns all supported currencies with their configuration and display names	None	ts	No
GET `/v1/settings/common/symbols`	Returns symbol settings with pricing and trading precision information	None	None	No
GET `/v1/settings/common/market-symbols`	Returns market symbol configuration for spot trading	None	None	No
GET `/v2/reference/currencies`	Returns currency and blockchain chain reference data	None	None	No
GET `/v1/common/timestamp`	Returns current server timestamp in milliseconds	None	None	No

Market Data Endpoints

Endpoint	Description	Required	Optional	Authentication
GET `/market/history/klines`	Returns OHLC candlestick data for the specified symbol and time period	symbol, period	size, from	No
GET `/market/detail`	Returns the latest market ticker data for a symbol including price, volume, and 24h stats	symbol	None	No
GET `/market/tickers`	Returns latest ticker data for all trading pairs	None	None	No
GET `/market/depth`	Returns order book depth (bids and asks) for a symbol	symbol, type	None	No
GET `/market/trade`	Returns the latest trade data for a symbol	symbol	None	No
GET `/market/history/trade`	Returns recent trades for a symbol	symbol	size	No
GET `/market/overview`	Returns 24-hour market summary statistics for all symbols	None	None	No
GET `/market/orderbook`	Returns complete order book for a symbol with full depth	symbol	depth	No

Account Endpoints

Endpoint	Description	Required	Optional	Authentication
GET `/v1/account/accounts`	Returns all account details for the authenticated user	None	None	Yes
GET `/v1/account/accounts/{account-id}/balance`	Returns balance details for a specific account including assets and liabilities	account-id	None	Yes
GET `/v2/account/valuation`	Returns total asset valuation for all accounts in the user's portfolio	None	valuationCurrency	Yes
GET `/v2/account/asset-valuation`	Returns detailed asset valuation and portfolio composition	None	None	Yes
POST `/v1/account/transfer`	Transfers assets between accounts	from-account, to-account, currency, amount	None	Yes
GET `/v1/account/history`	Returns account history and transaction records	None	account-id, currency, type	Yes
POST `/v1/futures/transfer`	Transfers funds between spot trading account and futures contract account	currency, amount, type	None	Yes
GET `/v1/point/account`	Returns current HTX points balance and history	None	None	Yes
POST `/v1/point/transfer`	Transfers HTX points between accounts	from-user, to-user, amount	None	Yes

Trading Endpoints

Endpoint	Description	Required	Optional	Authentication
POST `/v1/order/orders/place`	Places a new spot trading order (limit or market)	account-id, amount, symbol, type	price, client-order-id, source, time-in-force	Yes
POST `/v1/order/orders/{order-id}/cancel`	Cancels a pending order	order-id	None	Yes
POST `/v1/order/orders/batchcancel`	Cancels multiple orders matching specified criteria	None	account-id, symbol	Yes
GET `/v1/order/orders/{order-id}`	Returns details of a specific order	order-id	None	Yes
GET `/v1/order/orders`	Returns orders matching specified criteria (open, closed, cancelled)	account-id	symbol, states, types, start-time, end-time, from, direct, size	Yes
GET `/v1/order/orders/getClientOrder`	Returns order details using client-order-id	client-order-id	None	Yes
GET `/v1/order/matchresults`	Returns trade history and fill details	None	symbol, types, start-time, end-time, from, direct, size	Yes

Margin Loan (Cross/Isolated) Endpoints

Endpoint	Description	Required	Optional	Authentication
POST `/v1/margin/orders`	Applies for a margin loan on cross or isolated margin account	currency, amount	account-id	Yes
POST `/v1/margin/orders/{order-id}/repay`	Repays a margin loan with interest	order-id, amount	None	Yes
GET `/v1/margin/orders`	Returns margin loan orders and their status	None	currency, state, from, size	Yes
GET `/v1/margin/accounts/balance`	Returns detailed balance information for margin accounts	None	account-id	Yes

Parameters

Common Parameters

symbol: Trading symbol (e.g., btcusdt, ethusdt)
symbols: Comma-separated list of symbols
account-id: Account ID (can be obtained from /v1/account/accounts)
type: Order type
amount: Order amount (for buy market orders, amount is in quote currency; for others, in base currency)
price: Order price (required for limit orders)
source: Order source (default: spot-api)
client-order-id: Client-defined order ID (max length: 64)
self-match-prevent: Self-match prevention (0=disabled, 1=enabled)
stop-price: Stop price for stop-limit orders
operator: Operator for stop orders (gte, lte)
order-id: Order ID
period: Kline period/interval
size: Number of records to return
depth: Depth level (e.g., step0, step1, step2, etc.)
side: Order side (buy, sell)
states: Order states (comma-separated)
types: Order types (comma-separated)
start-date: Start date (format: yyyy-mm-dd)
end-date: End date (format: yyyy-mm-dd)
start-time: Start time (unix timestamp in milliseconds)
end-time: End time (unix timestamp in milliseconds)
from: Start ID for pagination
direct: Direction for pagination (prev, next)
accountType: Account type for asset valuation
valuationCurrency: Currency for valuation (e.g., BTC, USDT, CNY)
transactTypes: Transaction types (comma-separated)
limit: Number of records to return
fromId: Starting ID for query
currency: Currency name (lowercase, e.g., btc, usdt)
show-desc: Show description (true, false)
ts: Timestamp for querying (optional)
authorizedUser: Authorized user flag (true, false)

Enums

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

Authentication

For endpoints that require authentication, you will need to provide HTX API credentials. Required credentials:

apiKey: Your HTX API key (for AccessKeyId parameter)
secretKey: Your HTX API secret (for signing)

Base URLs:

Mainnet: https://api.huobi.pro
Mainnet (AWS): https://api-aws.huobi.pro

Security

Share Credentials

Users can provide HTX API credentials by sending a file where the content is in the following format:

fe45419a...xyz
secretabc...key

Never Display Full Secrets

When showing credentials to users:

API Key: Show first 5 + last 4 characters: fe45419a...xyz
Secret Key: Always mask, show only last 5: ***...key1

Example response when asked for credentials:

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

Listing Accounts

When listing accounts, show names and environment only — never keys:

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

Transactions in Mainnet

When performing transactions in mainnet, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.

HTX Accounts

main

API Key: your_mainnet_api_key
Secret: your_mainnet_secret
Environment: https://api.huobi.pro
Description: Primary trading account

trading

API Key: your_aws_api_key
Secret: your_aws_secret
Environment: https://api-aws.huobi.pro
Description: AWS optimized trading

TOOLS.md Structure

## 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 Behavior

Credentials requested: Mask secrets (show last 5 chars only)
Listing accounts: Show names and environment, never keys
Account selection: Ask if ambiguous, default to main
When doing a transaction in mainnet, confirm with user before by asking to write "CONFIRM" to proceed
New credentials: Prompt for name, environment

Adding New Accounts

When user provides new credentials:

Ask for account name
Ask: Which environment (Mainnet or Mainnet-AWS)
Store in TOOLS.md with masked display confirmation

Signing Requests

All authenticated endpoints require HMAC SHA256 signature:

Create the pre-sign string in the following order:
- HTTP method (GET/POST) + "\n"
- API host (e.g., api.huobi.pro) + "\n"
- API path (e.g., /v1/order/orders) + "\n"
- Sorted query string parameters
Append required parameters to all authenticated requests:
- AccessKeyId: Your API key
- SignatureMethod: HmacSHA256
- SignatureVersion: 2
- Timestamp: UTC timestamp in format yyyy-MM-ddTHH:mm:ss
Sign the pre-sign string with secretKey using HMAC SHA256
Append signature to query string as Signature parameter
For POST requests, also include signature in the URL query string

Example pre-sign string:

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 Header

Include User-Agent header with the following string: htx-spot/1.0.0 (Skill)

Important Notes

All timestamps are in Unix milliseconds
Symbol names should be lowercase (e.g., btcusdt, not BTCUSDT)
For market buy orders, the amount parameter represents the quote currency amount
For all other order types, amount represents the base currency amount
Account ID must be obtained from /v1/account/accounts endpoint before trading
Rate limits apply - see HTX API documentation for details
Signature must be calculated for every authenticated request
Timestamp in signature must be within 1 minute of server time
For order queries, the order created via API will no longer be queryable after being cancelled for more than 2 hours
The maximum query window for historical data is typically 48 hours, with data available for the last 180 days
When placing batch orders, maximum 10 orders per batch
Fee rates query supports maximum 10 trading pairs at a time
All request endpoints must match the endpoints specified in the documentation.

API Documentation

For more details, refer to the official HTX API documentation: https://www.htx.com/en-us/opend/newApiPages/