DeFiStream - Dashboard

Hyperliquid Exchange Data

Hyperliquid endpoints serve trade data (raw ticks and OHLCV candles) and derivatives metrics (fills, positions, funding) from the Hyperliquid decentralized perpetuals exchange.

All Hyperliquid endpoints use time ranges (since/until) and return CSV or Parquet.

Common Parameters:

Parameter	Type	Required	Description
`token`	string	Yes	Token symbol (e.g. `BTC`, `ETH`, `SOL`)
`since`	string	Yes	Start timestamp (ISO 8601 or Unix seconds)
`until`	string	Yes	End timestamp (ISO 8601 or Unix seconds)
`format`	string	No	`csv` (default), `parquet`, or `json` (OHLCV only)
`link`	boolean	No	Return a download URL instead of data directly

Raw Trades

Endpoint: GET /v1/exchange/hyperliquid/raw_trades

Tick-level trade records from Hyperliquid.

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/exchange/hyperliquid/raw_trades?token=BTC&since=2025-12-01&until=2025-12-02" 
  -o hl_trades.csv

Sample Results:

time	price	amount	buy
2025-12-01T00:00:01.123Z	97500.0	0.025	true
2025-12-01T00:00:01.456Z	97498.5	0.100	false
2025-12-01T00:00:02.012Z	97501.0	0.050	true

OHLCV Candles

Endpoint: GET /v1/exchange/hyperliquid/ohlcv

OHLCV candles aggregated to the requested window. Supports JSON, CSV, and Parquet.

Additional Parameters:

Parameter	Type	Required	Description
`window`	string	No	Candle window: `1m`, `5m`, `15m`, `30m`, `1h` (default), `4h`, `1d`

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/exchange/hyperliquid/ohlcv?token=ETH&window=1h&since=2025-12-01&until=2025-12-08"

Sample Results:

time	open	high	low	close	volume	trade_count
2025-12-01T00:00:00Z	3850.2	3880.5	3830.1	3870.8	4521.3	12450
2025-12-01T01:00:00Z	3870.8	3900.0	3860.3	3895.5	3892.7	10870

Fills

Endpoint: GET /v1/exchange/hyperliquid/fills

Individual trade fills with execution details.

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/exchange/hyperliquid/fills?token=BTC&since=2025-12-01&until=2025-12-02" 
  -o hl_fills.csv

Positions

Endpoint: GET /v1/exchange/hyperliquid/positions

Position snapshots across Hyperliquid perpetual markets.

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/exchange/hyperliquid/positions?token=ETH&since=2025-12-01&until=2025-12-02" 
  -o hl_positions.csv

Funding

Endpoint: GET /v1/exchange/hyperliquid/funding

Funding rate data for Hyperliquid perpetual contracts.

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/exchange/hyperliquid/funding?token=BTC&since=2025-12-01&until=2025-12-31" 
  -o hl_funding.csv

Sample Results:

time	token	rate
2025-12-01T00:00:00Z	BTC	0.0001
2025-12-01T01:00:00Z	BTC	0.00009
2025-12-01T02:00:00Z	BTC	0.00011

Quota & Limits

Hyperliquid endpoints use a day-based quota model. Cost is calculated as max(100, days_queried × daily_cost).

Time range limit: Maximum 31 days per request.

Endpoint	Cost per day	Example (7 days)
`fills`, `trades`	1,000	7,000
`ohlcv`, `positions`	100	700
`funding`, `transfers`, `vaults`, `sends`, `spot_transfers`	10	100 (min)

Check response headers X-RateLimit-Remaining and X-Request-Cost to monitor usage.