| name | htx/futures-market |
| version | 2.0.0 |
| description | HTX USDT-M perpetual futures core market data — contract info / klines / ticker / order book / index price / system status. |
| auth | false |
| risk | low |
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
htx-cli futures-market detail-merged -p contract_code=BTC-USDT
htx-cli futures-market kline -p contract_code=ETH-USDT -p period=60min -p size=200
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-USDT
period — 1min 5min 15min 30min 60min 4hour 1day 1week 1mon
size — Number of klines returned, 1-2000
type — Order book aggregation: step0 to step19
business_type — swap (USDT perpetual) / futures (delivery) / all
Typical scenarios
"What is the premium of the BTC perpetual over spot?"
htx-cli futures-market detail-merged -p contract_code=BTC-USDT
htx-cli spot-market market-detail-merged -p symbol=btcusdt
"Top coins by ETH perpetual 24h turnover"
htx-cli futures-market detail-batch-merged -p business_type=swap
"What is the contract size of the BTC perpetual?"
htx-cli futures-market contract-info -p contract_code=BTC-USDT
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
- 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