Overview
Hyperliquid is an L1 blockchain purpose-built for a perpetual futures DEX. It runs a fully on-chain order book with sub-second finality, offering a CEX-like trading experience without centralized custody. Kwery ingests Hyperliquid's OHLCV data along with optional derivatives fields like funding rate and open interest.
What we ingest
- OHLCV candlestick data for perpetual contracts
- Funding rate (optional, when available for the interval)
- Open interest (optional, when available for the interval)
Currently tracked assets: BTC, ETH, SOL, XRP.
Data semantics
| Concept | Detail |
|---|---|
| Symbol format | Coin name — BTC, not BTCUSDT or BTC-PERP |
| Quote currency | USD (settled in USDC) |
| Contract type | Perpetual futures (no expiry) |
| Funding rate | Hourly funding, unlike Binance's 8-hour cycle |
| Open interest | Total outstanding notional |
ℹ️Info
Hyperliquid uses coin names as symbols. When querying, use BTC, ETH, etc. — not exchange-style pair notation like BTCUSDT. This is consistent across all Kwery sources.
Available endpoints
List available symbols
GET /v1/hyperliquid
Returns all tracked Hyperliquid perpetual symbols and their metadata.
curl "https://kwery-api.com/v1/hyperliquid?api-key=YOUR_KEY"
{
"source": "hyperliquid",
"symbols": [
{ "symbol": "BTC", "contract_type": "perpetual", "status": "active" },
{ "symbol": "ETH", "contract_type": "perpetual", "status": "active" },
{ "symbol": "SOL", "contract_type": "perpetual", "status": "active" },
{ "symbol": "XRP", "contract_type": "perpetual", "status": "active" }
]
}
Get OHLCV candles
GET /v1/hyperliquid/{symbol}
Returns OHLCV candlestick data with optional funding rate and open interest.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
symbol | string | Yes | — | Coin name (e.g. BTC, ETH, SOL, XRP) |
interval | string | Yes | — | Candle interval: 5m, 15m, 1h, 4h, 24h |
start | string | No | — | ISO 8601 start time |
end | string | No | — | ISO 8601 end time |
limit | integer | No | 100 | Maximum candles to return |
offset | integer | No | 0 | Number of records to skip |
curl "https://kwery-api.com/v1/hyperliquid/BTC?api-key=YOUR_KEY&interval=1h&limit=3"
{
"symbol": "BTC",
"source": "hyperliquid",
"interval": "1h",
"candles": [
{
"timestamp": "2026-03-09T12:00:00Z",
"open": 78310.50,
"high": 78520.00,
"low": 78140.80,
"close": 78405.30,
"volume": 890.45,
"funding_rate": 0.000035,
"open_interest": 42150.80
},
{
"timestamp": "2026-03-09T11:00:00Z",
"open": 78170.20,
"high": 78350.90,
"low": 78060.50,
"close": 78310.50,
"volume": 765.32,
"funding_rate": 0.000032,
"open_interest": 41890.20
},
{
"timestamp": "2026-03-09T10:00:00Z",
"open": 77950.00,
"high": 78210.40,
"low": 77880.60,
"close": 78170.20,
"volume": 620.18,
"funding_rate": 0.000028,
"open_interest": 41520.50
}
],
"total": 720,
"limit": 3,
"offset": 0
}
Source-specific fields
| Field | Type | Description |
|---|---|---|
open | float | Opening price (USD) |
high | float | Highest price in interval |
low | float | Lowest price in interval |
close | float | Closing price (USD) |
volume | float | Total traded volume (base asset units) |
funding_rate | float | null | Hourly funding rate (e.g. 0.000035 = 0.0035%). null if not available for the interval. |
open_interest | float | null | Total outstanding contract value (base asset units). null if not available. |
timestamp | string | ISO 8601 interval open time |
Available intervals
| Interval | Description | Minimum plan |
|---|---|---|
5m | 5-minute candles | Free |
15m | 15-minute candles | Free |
1h | Hourly candles | Free |
4h | 4-hour candles | Free |
24h | Daily candles | Free |
Limitations & notes
- Hourly funding, not 8-hour. Unlike Binance Futures, Hyperliquid settles funding every hour. This means
funding_ratevalues are smaller per settlement but more frequent. Do not directly compare a Hyperliquid hourly rate to a Binance 8-hour rate without annualizing or normalizing. funding_rateandopen_interestare optional. These fields may benullon certain intervals or during periods where the data is unavailable. Always handle the null case in your code.- Coin names, not pair symbols. Use
BTC,ETH, etc. Hyperliquid natively uses coin names, and Kwery follows the same convention. - No ticker endpoint. Unlike Binance, Hyperliquid does not currently have a 1-second ticker endpoint in Kwery. Use 5-minute candles as the finest available granularity.
- On-chain settlement. All trades settle on the Hyperliquid L1. During periods of chain congestion (rare but possible), there may be slight delays in data availability.
- Useful for cross-venue comparison. Comparing Hyperliquid perp prices against Binance Futures lets you detect basis differentials between centralized and decentralized venues — valuable for funding rate arbitrage strategies. See the Funding Rate Arbitrage guide.