Skip to main content

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

ConceptDetail
Symbol formatCoin name — BTC, not BTCUSDT or BTC-PERP
Quote currencyUSD (settled in USDC)
Contract typePerpetual futures (no expiry)
Funding rateHourly funding, unlike Binance's 8-hour cycle
Open interestTotal 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.

ParameterTypeRequiredDefaultDescription
symbolstringYesCoin name (e.g. BTC, ETH, SOL, XRP)
intervalstringYesCandle interval: 5m, 15m, 1h, 4h, 24h
startstringNoISO 8601 start time
endstringNoISO 8601 end time
limitintegerNo100Maximum candles to return
offsetintegerNo0Number 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

FieldTypeDescription
openfloatOpening price (USD)
highfloatHighest price in interval
lowfloatLowest price in interval
closefloatClosing price (USD)
volumefloatTotal traded volume (base asset units)
funding_ratefloat | nullHourly funding rate (e.g. 0.000035 = 0.0035%). null if not available for the interval.
open_interestfloat | nullTotal outstanding contract value (base asset units). null if not available.
timestampstringISO 8601 interval open time

Available intervals

IntervalDescriptionMinimum plan
5m5-minute candlesFree
15m15-minute candlesFree
1hHourly candlesFree
4h4-hour candlesFree
24hDaily candlesFree

Limitations & notes

  • Hourly funding, not 8-hour. Unlike Binance Futures, Hyperliquid settles funding every hour. This means funding_rate values 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_rate and open_interest are optional. These fields may be null on 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.