htx-exchange Spot Market
Read public spot market data from HTX. No API key required; all endpoints are public.
When to use
- Query a single symbol's real-time price, 24h change, volume
- Pull klines (minute / hour / day / week / month periods)
- View order book depth (bid/ask 5/10/20 levels)
- Market-wide scan (snapshot of all symbol tickers)
- Look up currency / symbol metadata (precision, minimum order size)
Quick start
# Query BTC/USDT latest market data
htx-cli spot-market market-detail-merged -p symbol=btcusdt
# Pull last 100 ETH/USDT 4h klines
htx-cli spot-market kline -p symbol=ethusdt -p period=4hour -p size=100
# Query market-wide tickers
htx-cli spot-market tickers
Available commands (13 endpoints)
Market data
| Command | HTX endpoint | Description |
|---|---|---|
market-detail-merged |
GET /market/detail/merged |
Single-symbol real-time summary (latest price + 24h stats) |
market-detail |
GET /market/detail |
Single-symbol 24h stats detail |
tickers |
GET /market/tickers |
Market-wide ticker snapshot for all symbols |
kline |
GET /market/history/kline |
Historical klines (period: 1min / 5min / 15min / 30min / 60min / 4hour / 1day / 1week / 1mon) |
depth |
GET /market/depth |
Order book depth (type: step0 / step1 / step2 / step3 / step4 / step5) |
trade |
GET /market/trade |
Latest single trade |
history-trade |
GET /market/history/trade |
Historical trades (max 2000) |
Metadata
| Command | HTX endpoint | Description |
|---|---|---|
symbols |
GET /v1/common/symbols |
List of all tradable symbols (precision, min order size, status) |
currencys |
GET /v1/common/currencys |
List of all currencies |
currencies-v2 |
GET /v2/reference/currencies |
Currency detail (with deposit/withdraw status) |
market-status |
GET /v2/market-status |
Market status (normal / halted / cancel-only) |
timestamp |
GET /v1/common/timestamp |
Server timestamp |
chains |
GET /v1/settings/common/chains |
Chain info |
Parameter reference
symbol— symbol in lowercase without separators, e.g.btcusdt/ethusdt/solusdtperiod— kline period:1min5min15min30min60min4hour1day1week1monsize— number of records, 1-2000type— depth aggregation precision:step0(no aggregation) tostep5(coarsest)depth— number of levels: 5 / 10 / 20
Typical scenarios
"How much is BTC right now?"
htx-cli spot-market market-detail-merged -p symbol=btcusdt
# → close field is the latest price
"ETH 4h kline trend"
htx-cli spot-market kline -p symbol=ethusdt -p period=4hour -p size=200
"Top 10 24h gainers"
htx-cli spot-market tickers
# AI Agent parses the data array, sorts by (close-open)/open and takes the top 10
"SOL order book depth"
htx-cli spot-market depth -p symbol=solusdt -p type=step0 -p depth=20
Output schema excerpt
market-detail-merged returns:
{
"ch": "market.btcusdt.detail.merged",
"ts": 1712345678901,
"tick": {
"id": 12345,
"open": 65000.0,
"close": 66100.0,
"high": 66500.0,
"low": 64800.0,
"amount": 12345.67,
"vol": 815432100.5,
"count": 102345,
"bid": [66099.5, 0.5],
"ask": [66100.5, 0.3]
}
}
Notes
- Public endpoint rate limit: roughly 100/s per IP; use
tickersfor one-shot aggregate queries - For COIN-M perpetual / delivery futures market data, use
htx/futures-market - For specialized data such as funding rate, open interest, liquidations, see the dedicated skill (
htx/funding-rate/htx/oi-tracker/htx/liquidation-stream)
Installation
curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- spot-market
Related docs
- HTX official API: https://huobiapi.github.io/docs/spot/v1/cn/
- Full README: ./README.md