Market Data

Public market data endpoints. No authentication required. Rate limited to 60 req/min per IP without an API key.

List all coins

get

Returns all active Hyperliquid perpetual markets with current funding rate metrics. Use this endpoint to populate coin selectors, build funding rate scanners, or rank markets by yield opportunity.

Predicted funding rates are sourced from Hyperliquid's predictedFundings endpoint and include cross-exchange predictions (HlPerp, BinancePerp, BybitPerp).

Responses

200

List of all active coins with funding metrics.

application/json

502

Internal server error.

application/json

get

/api/coins

HTTPcURLJavaScriptPython

GET /api/coins HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coins": [
    {
      "name": "BTC",
      "max_leverage": 50,
      "mark_px": 95432.1,
      "change_24h": 2.34,
      "volume_24h": 1234567890.12,
      "open_interest": 5678901234.56,
      "funding_1h": 0.0000123,
      "predicted_funding": 0.0000135,
      "has_spot": true
    }
  ]
}

Get funding rate history

get

Returns up to 90 days of hourly funding rate history for a single coin. Data is sourced from ClickHouse first, with Hyperliquid gap-fill for missing recent records.

Hyperliquid settles funding every 1 hour, so up to 2160 records may be returned. All rates are normalized to a 1-hour basis regardless of the exchange interval.

Path parameters

coinstringRequired

Asset symbol (uppercase). Example: BTC, ETH, HYPE.

Example: BTC

Responses

200

Funding rate history with current rate summary.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

get

/api/funding-rates/{coin}

HTTPcURLJavaScriptPython

GET /api/funding-rates/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "current": {
    "timestamp": 1736553600,
    "exchange": "hyperliquid",
    "coin": "BTC",
    "rate_1h": 0.0000123,
    "daily_yield": 0.02952,
    "apr": 10.77
  },
  "rates": [
    {
      "timestamp": 1736553600,
      "exchange": "hyperliquid",
      "coin": "BTC",
      "rate_1h": 0.0000123,
      "daily_yield": 0.02952,
      "apr": 10.77
    }
  ]
}

Get market statistics

get

Returns current market statistics for a single coin: mark price, oracle price, 24-hour change and volume, open interest, current and predicted funding rate, max leverage, and spot market availability.

Path parameters

coinstringRequired

Asset symbol (uppercase). Example: BTC, ETH, HYPE.

Example: BTC

Responses

200

Current market statistics for the requested coin.

application/json

404

Requested resource not found.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

get

/api/market-stats/{coin}

HTTPcURLJavaScriptPython

GET /api/market-stats/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "mark_px": 95432.1,
  "oracle_px": 95400.5,
  "change_24h": 2.34,
  "volume_24h": 1234567890.12,
  "open_interest": 5678901234.56,
  "funding_1h": 0.0000123,
  "predicted_funding": 0.0000135,
  "max_leverage": 50,
  "has_spot": true,
  "spot_px": 95398
}

Get order book

get

Returns the current L2 order book for a coin, proxied from Hyperliquid. Returns up to 16 price levels on each side with cumulative size.

Use the market query parameter to switch between the perpetual and spot order books. Spot market availability can be checked via has_spot in /api/market-stats/{coin}.

Path parameters

coinstringRequired

Asset symbol (uppercase). Example: BTC, ETH, HYPE.

Example: BTC

Query parameters

marketstring · enumOptional

Market type. Defaults to perp. Use spot to retrieve the native spot order book.

Default: perpPossible values:

Responses

200

Current order book snapshot.

application/json

404

Requested resource not found.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

get

/api/orderbook/{coin}

HTTPcURLJavaScriptPython

GET /api/orderbook/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "time": 1736553612345,
  "bids": [
    {
      "price": 95430,
      "size": 0.5234,
      "total": 0.5234
    },
    {
      "price": 95425,
      "size": 0.81,
      "total": 1.3334
    }
  ],
  "asks": [
    {
      "price": 95435,
      "size": 0.31,
      "total": 0.31
    },
    {
      "price": 95440,
      "size": 0.65,
      "total": 0.96
    }
  ]
}

Get OHLCV candles

get

Returns OHLCV candlestick data for a coin for both the perpetual and spot markets. Data covers the last 30 days for the requested interval.

Valid intervals: 1m, 5m, 15m, 1h, 4h, 1d. Invalid values default to 1h. The spot array is empty if no liquid spot market exists for the coin.

Path parameters

coinstringRequired

Asset symbol (uppercase).

Example: BTC

Query parameters

intervalstring · enumOptional

Candlestick interval. Defaults to 1h.

Default: 1hPossible values:

Responses

200

OHLCV candle data for the requested coin and interval.

application/json

429

Rate limit exceeded.

application/json

502

Internal server error.

application/json

get

/api/candles/{coin}

HTTPcURLJavaScriptPython

GET /api/candles/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "interval": "1h",
  "perp": [
    {
      "t": 1736550000000,
      "o": 95100,
      "h": 95600,
      "l": 94900,
      "c": 95432.1,
      "v": 123.456,
      "n": 3421
    }
  ],
  "spot": [
    {
      "t": 1736550000000,
      "o": 95100,
      "h": 95600,
      "l": 94900,
      "c": 95432.1,
      "v": 123.456,
      "n": 3421
    }
  ]
}

Get microstructure indicators

get

Returns 30 days of 5-minute microstructure signal buckets for a coin from the Hyperflow ClickHouse pipeline.

Each bucket contains CVD (cumulative volume delta), open interest, long and short liquidation volumes, and buy/sell volume. This data powers the Zirodelta analytics charts and the Farm Score model.

Returns 503 if the ClickHouse database is unavailable.

Path parameters

coinstringRequired

Asset symbol (uppercase).

Example: BTC

Responses

200

5-minute microstructure indicator buckets for the last 30 days.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

503

ClickHouse database unavailable.

application/json

get

/api/indicators/{coin}

HTTPcURLJavaScriptPython

GET /api/indicators/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "points": [
    {
      "t": 1736550000,
      "cvd": 125000.5,
      "oi": 5678901234,
      "ll": 45000,
      "sl": 12000,
      "bv": 875000,
      "sv": 750000
    }
  ]
}

Get market flow data

get

Returns aggregated market flow data including CVD, open interest, funding rate, liquidation volumes, and whale net flow for configurable time windows and bucket sizes.

The summary object provides a composite risk signal (green/amber/red) based on CVD magnitude and large liquidation count over the last 1 hour.

Path parameters

coinstringRequired

Asset symbol (uppercase).

Example: BTC

Query parameters

hoursinteger · min: 1 · max: 720Optional

Lookback window in hours. Minimum 1, maximum 720 (30 days). Defaults to 720.

Default: 720

bucketinteger · min: 5 · max: 1440Optional

Bucket size in minutes for aggregation. Minimum 5, maximum 1440. Defaults to 5.

Default: 5

Responses

200

Aggregated flow data with risk summary.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

503

ClickHouse database unavailable.

application/json

get

/api/flow/{coin}

HTTPcURLJavaScriptPython

GET /api/flow/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "coin": "BTC",
  "buckets": [
    {
      "t": 1736550000,
      "cvd": 250000,
      "oi": 5678901234,
      "funding": 0.0000123,
      "long_liq": 45000,
      "short_liq": 12000,
      "whale_net": 1200000
    }
  ],
  "summary": {
    "cvd_1h": 3500000,
    "oi_change_pct": 4.2,
    "liq_count_1h": 1,
    "risk": "amber"
  }
}

Get crowd positioning leaderboard

get

Returns crowd positioning data for all Hyperliquid coins. Open interest comes from Hyperliquid. Long/short ratio and taker buy/sell ratio are sourced from Binance or Bybit snapshots (updated every 10 minutes by the settled-oracle service).

Coins without Binance/Bybit data will have null values for ls_ratio, long_pct, short_pct, and taker_bs_ratio.

Responses

200

Crowd positioning for all coins.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

503

ClickHouse database unavailable.

application/json

get

/api/crowd/leaderboard

HTTPcURLJavaScriptPython

GET /api/crowd/leaderboard HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "entries": [
    {
      "symbol": "BTCUSDT",
      "long_pct": 52.3,
      "short_pct": 47.7,
      "ls_ratio": 1.097,
      "taker_bs_ratio": 1.05,
      "oi_value_usd": 5678901234
    }
  ]
}

Get crowd snapshot for a coin

get

Returns the latest crowd positioning snapshot for a single coin. OI data comes from Hyperliquid. Long/short ratio and taker buy/sell ratio are joined from Binance or Bybit if available within the last 2 hours.

Returns 404 if no Hyperliquid OI data exists for the coin within the last 2 hours.

Path parameters

coinstringRequired

Asset symbol (uppercase, without USDT suffix). Example: BTC, ETH.

Example: BTC

Responses

200

Latest crowd positioning snapshot.

application/json

404

Requested resource not found.

application/json

429

Rate limit exceeded.

application/json

503

ClickHouse database unavailable.

application/json

get

/api/crowd/{coin}/latest

HTTPcURLJavaScriptPython

GET /api/crowd/{coin}/latest HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "long_pct": 52.3,
  "short_pct": 47.7,
  "ls_ratio": 1.097,
  "taker_bs_ratio": 1.05,
  "oi_value_usd": 5678901234,
  "snapshot_time": "2025-01-11 08:00:00"
}

Get crowd data for a coin (alias)

get

Alias for GET /api/crowd/{coin}/latest. Returns the same crowd positioning snapshot.

Path parameters

coinstringRequired

Asset symbol (uppercase, without USDT suffix).

Example: BTC

Responses

200

Latest crowd positioning snapshot.

application/json

404

Requested resource not found.

application/json

429

Rate limit exceeded.

application/json

503

ClickHouse database unavailable.

application/json

get

/api/crowd/{coin}

HTTPcURLJavaScriptPython

GET /api/crowd/{coin} HTTP/1.1
Host: api.dex.zirodelta.xyz
Accept: */*

{
  "long_pct": 52.3,
  "short_pct": 47.7,
  "ls_ratio": 1.097,
  "taker_bs_ratio": 1.05,
  "oi_value_usd": 5678901234,
  "snapshot_time": "2025-01-11 08:00:00"
}