# HTX API
> Live spot market data from HTX (formerly Huobi), one of the longest-running centralised crypto exchanges and a leading venue in Asian markets. The ticker endpoint returns a symbol's 24h last price, open, high, low, best bid/ask, base and quote volume, trade count and change. The tickers endpoint returns the top symbols by 24h quote volume. The symbols endpoint searches HTX's spot trading pairs. Read live from HTX, nothing stored. This is HTX's own spot ticker and market layer — a distinct centralised-exchange venue, separate from other exchange feeds and from DEX, lending and oracle APIs.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/htx-api/..."
```

## Pricing
- **Free** (Free) — 2,400 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 66,000 calls/Mo, 15 req/s
- **Pro** ($24/Mo) — 340,000 calls/Mo, 40 req/s
- **Scale** ($55/Mo) — 2,150,000 calls/Mo, 120 req/s

## Endpoints

### Ticker

#### `GET /v1/ticker` — A symbol 24h ticker

**Parameters:**
- `symbol` (query, required, string) — Symbol (btcusdt or btc) Example: `btcusdt`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/htx-api/v1/ticker?symbol=btcusdt"
```

**Response:**
```json
{
    "data": {
        "ask": 61443.02,
        "bid": 61442.45,
        "low": 60744.39,
        "high": 62834,
        "last": 61441.83,
        "open": 61700.01,
        "source": "HTX",
        "symbol": "btcusdt",
        "trades_24h": 27450,
        "change_24h_pct": -0.4184,
        "base_volume_24h": 1016.8727,
        "quote_volume_24h": 62764034.33
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:37.230Z",
        "request_id": "2c601425-1312-4937-9807-19697ccdfd55"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Tickers

#### `GET /v1/tickers` — Top symbols by 24h quote volume

**Parameters:**
- `quote` (query, optional, string) — Quote asset (usdt default) Example: `usdt`
- `limit` (query, optional, string) — Max results (1-200) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/htx-api/v1/tickers?quote=usdt&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "quote": "usdt",
        "source": "HTX",
        "tickers": [
            {
                "ask": 61443.03,
                "bid": 61443.02,
                "low": 61111.12,
                "high": 62649.15,
                "last": 61441.82,
                "open": 62641.78,
                "symbol": "btcusdt",
                "trades_24h": 27450,
                "change_24h_pct": -1.9156,
                "base_volume_24h": 1016.8727,
                "quote_volume_24h": 62764034.33
            },
            {
                "ask": 1.717e-6,
                "bid": 1.716e-6,
                "low": 1.711e-6,
                "high": 1.721e-6,
                "last": 1.716e-6,
                "open": 1.721e-6,
                "symbol": "htxusdt",
                "trades_24h": 12271,
                "change_24h_pct": -0.2905,
                "base_volume_24h": 24630963787069.434,
                "quote_volume_24h": 42300992.08
            },
            {
                "ask": 1619.35,
                "bid": 1618.92,
                "low": 1607,
                "high": 1658.72,
                "last": 1619.2,
                "open": 1658.28,
                "symbol": "ethusdt",
                "trades_24h": 41812,
                "change_24h_pct": -2.3567,
                "base_volume_24h": 19291.2785,
                "quote_volume_24h": 31550569.86
            },
            {
                "ask": 4050.4,
                "bid": 4
…(truncated, see openapi.json for full schema)
```

### Symbols

#### `GET /v1/symbols` — Search spot trading pairs

**Parameters:**
- `q` (query, required, string) — Search query (min 2 chars) Example: `btc`
- `limit` (query, optional, string) — Max results (1-200) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/htx-api/v1/symbols?q=btc&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "btc",
        "source": "HTX",
        "symbols": [
            {
                "last": 61441.82,
                "symbol": "btcusdt",
                "quote_volume_24h": 62764034.33
            },
            {
                "last": 61292.31,
                "symbol": "btcusdd",
                "quote_volume_24h": 624342.21
            },
            {
                "last": 62100.64,
                "symbol": "btcusdc",
                "quote_volume_24h": 18513.43
            },
            {
                "last": 0.026565,
                "symbol": "ethbtc",
                "quote_volume_24h": 0.36
            },
            {
                "last": 5.2815e-6,
                "symbol": "trxbtc",
                "quote_volume_24h": 0.1
            },
            {
                "last": 0.000678,
                "symbol": "ltcbtc",
                "quote_volume_24h": 0.09
            },
            {
                "last": 1.7756e-5,
                "symbol": "xrpbtc",
                "quote_volume_24h": 0.02
            },
            {
                "last": 2.58e-6,
                "symbol": "adabtc",
                "quote_volume_24h": 0.01
            },
            {
                "last": 0.00101735,
                "symbol": "solbtc",
                "quote_volume_24h": 0.01
            },
            {
                "last": 1.3381e-6,
                "symbol": "dogebtc",
                "quote_vol
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/htx-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "HTX API (api.huobi.pro, live)",
        "service": "htx-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "A symbol's 24h ticker (symbol=btcusdt or btc).",
            "GET /v1/symbols": "Search spot trading pairs (q=btc, limit=50).",
            "GET /v1/tickers": "Top symbols by 24h quote volume (quote=usdt, limit=25)."
        },
        "description": "Live spot market data from HTX (formerly Huobi), one of the longest-running centralised crypto exchanges and a leading venue in Asian markets. The ticker endpoint returns a symbol's 24h last price, open, high, low, best bid/ask, base and quote volume, trade count and change; the tickers endpoint returns the top symbols by 24h quote volume; the symbols endpoint searches HTX's spot trading pairs. Live, no key, nothing stored. Distinct centralised-exchange venue, separate from other exchange feeds and from DEX, lending and oracle APIs — this is HTX's own spot ticker and market layer.",
        "symbol_count": 629,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:38.192Z",
        "request_id": "91875d36-24a5-49a7-aafd-02bdb3699d86"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/htx-api
OpenAPI spec: https://www.oanor.com/api/htx-api/openapi.json