htx-exchange Futures Market
Read public market data for HTX USDT-M perpetual futures. No API key required.
Specialized data such as funding rate, open interest, liquidations, mark price / basis has been split into dedicated skills. This skill only covers general market data.
When to use
- Query perpetual real-time price, 24h statistics, index price
- Pull klines (standard klines, not mark price / premium index)
- View order book depth
- Check contract metadata (contract size, precision, listing status)
- Check exchange system status
Quick start
# BTC perpetual latest market data
htx-cli futures-market detail-merged -p contract_code=BTC-USDT
# ETH perpetual 1h klines
htx-cli futures-market kline -p contract_code=ETH-USDT -p period=60min -p size=200
# All perpetual contract info
htx-cli futures-market contract-info
Available commands (15 endpoints)
Market data
| Command | HTX endpoint | Description |
|---|---|---|
detail-merged |
GET /linear-swap-ex/market/detail/merged |
Single-contract real-time summary |
detail-batch-merged |
GET /linear-swap-ex/market/detail/batch_merged |
Batch real-time summary across contracts |
kline |
GET /linear-swap-ex/market/history/kline |
Historical klines |
depth |
GET /linear-swap-ex/market/depth |
Order book depth |
bbo |
GET /linear-swap-ex/market/bbo |
Best bid/offer |
trade |
GET /linear-swap-ex/market/trade |
Latest single trade |
history-trade |
GET /linear-swap-ex/market/history/trade |
Historical trades |
Index and fair-value prices
| Command | HTX endpoint | Description |
|---|---|---|
index-price |
GET /linear-swap-api/v1/swap_index |
Real-time index price |
For mark price / premium index / basis klines, use
htx/mark-price
Metadata
| Command | HTX endpoint | Description |
|---|---|---|
contract-info |
GET /linear-swap-api/v1/swap_contract_info |
Contract metadata |
query-elements |
GET /linear-swap-api/v1/swap_query_elements |
Contract elements (precision, size) |
risk-info |
GET /linear-swap-api/v1/swap_risk_info |
Platform risk reserve fund |
funding-rate-cap |
GET /linear-swap-api/v1/swap_funding_rate_cap_info |
Funding rate upper/lower bounds |
System status
| Command | HTX endpoint | Description |
|---|---|---|
timestamp |
GET /api/v1/timestamp |
Server time |
heartbeat |
GET /heartbeat/ |
System heartbeat and status |
transfer-state |
GET /linear-swap-api/v1/swap_transfer_state |
Transfer switch state |
Parameter reference
contract_code— Contract code, uppercase with hyphen, e.g.BTC-USDT/ETH-USDT/SOL-USDTperiod—1min5min15min30min60min4hour1day1week1monsize— Number of klines returned, 1-2000type— Order book aggregation:step0tostep19business_type—swap(USDT perpetual) /futures(delivery) /all
Typical scenarios
"What is the premium of the BTC perpetual over spot?"
# Perpetual latest price
htx-cli futures-market detail-merged -p contract_code=BTC-USDT
# Spot latest price
htx-cli spot-market market-detail-merged -p symbol=btcusdt
# AI Agent compares the two to compute the premium percentage
"Top coins by ETH perpetual 24h turnover"
htx-cli futures-market detail-batch-merged -p business_type=swap
# Parse and sort by the vol field
"What is the contract size of the BTC perpetual?"
htx-cli futures-market contract-info -p contract_code=BTC-USDT
# contract_size field: BTC-USDT = 0.001 BTC per contract
Notes
- This skill only covers general market data. For specialized data, use the dedicated skill:
- Funding rate →
htx/funding-rate - Open interest →
htx/oi-tracker - Long/short ratio →
htx/elite-positioning - Liquidation orders →
htx/liquidation-stream - Mark price / basis →
htx/mark-price - Settlement / insurance fund →
htx/settlement
- Funding rate →
- For write operations (order placement, leverage change), use
htx/futures-trading - For account queries, use
htx/futures-account
Installation
curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- futures-market
Related docs
- HTX perpetual futures API: https://huobiapi.github.io/docs/usdt_swap/v1/cn/