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
chevron-right
200

List of all active coins with funding metrics.

application/json
get
/api/coins

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
chevron-right
200

Funding rate history with current rate summary.

application/json
get
/api/funding-rates/{coin}

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
chevron-right
200

Current market statistics for the requested coin.

application/json
get
/api/market-stats/{coin}

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
chevron-right
200

Current order book snapshot.

application/json
get
/api/orderbook/{coin}

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
chevron-right
200

OHLCV candle data for the requested coin and interval.

application/json
get
/api/candles/{coin}

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
chevron-right
200

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

application/json
get
/api/indicators/{coin}

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
chevron-right
200

Aggregated flow data with risk summary.

application/json
get
/api/flow/{coin}

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
chevron-right
200

Crowd positioning for all coins.

application/json
get
/api/crowd/leaderboard

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
chevron-right
200

Latest crowd positioning snapshot.

application/json
get
/api/crowd/{coin}/latest

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
chevron-right
200

Latest crowd positioning snapshot.

application/json
get
/api/crowd/{coin}

Last updated

Was this helpful?