SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillshtx/spot-market

htx/spot-market

Data & analytics

View repository

Updated 10-15 22:14

About this skill

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` / `solusdt`
- `period` — kline period: `1min` `5min` `15min` `30min` `60min` `4hour` `1day` `1week` `1mon`
- `size` — number of records, 1-2000
- `type` — depth aggregation precision: `step0` (no aggregation) to `step5` (coarsest)
- `depth` — number of levels: 5 / 10 / 20

## Typical scenarios

**"How much is BTC right now?"**
```bash
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 tickers for 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