Open interest

Open interest is the total size of outstanding contracts, plus the mark, oracle, and mid prices that move with it. Hyperliquid core, HIP-3, HIP-4, and Lighter serve open interest; Spot does not.

Get open interest

Hyperliquid
HIP-3
HIP-4
Lighter

curl "https://api.0xarchive.io/v1/hyperliquid/openinterest/BTC/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/current is the snapshot; /v1/hyperliquid/openinterest/{symbol} paginates history.

curl "https://api.0xarchive.io/v1/hyperliquid/hip3/openinterest/km:US500/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/hip3/openinterest/{symbol} and /current. Namespaced builder symbols, case-sensitive.

curl "https://api.0xarchive.io/v1/hyperliquid/hip4/openinterest/%230/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/hip4/openinterest/{symbol} and /current. Outcome side ids such as %230.

curl "https://api.0xarchive.io/v1/lighter/openinterest/{symbol}/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/lighter/openinterest/{symbol} and /current. Find symbols on /v1/lighter/instruments.

Request parameters

Parameter	In	Type	Required	Description
`symbol`	path	string	Yes	Trading pair symbol, e.g. `BTC`
`start`	query	integer (ms)	No	Start time, Unix ms. Defaults to 24h ago
`end`	query	integer (ms)	No	End time, Unix ms. Defaults to now
`interval`	query	string	No	Aggregation interval; omit for raw ~1 min resolution
`limit`	query	integer	No	Max results. Default 100, max 1000
`cursor`	query	integer	No	Pagination cursor

{
  "success": true,
  "data": {
    "coin": "BTC", "symbol": "BTC", "timestamp": "2026-06-05T16:44:24.247Z",
    "open_interest": "33091.28243", "mark_price": "60803", "oracle_price": "60830", "mid_price": "60785.5",
    "day_ntl_volume": "6499523469.57", "prev_day_price": "63741", "impact_bid_price": "60781", "impact_ask_price": "60790"
  },
  "meta": { "request_id": "req_5c2e9a14f7b03d68" }
}

Response fields

Field	Type	Description
`symbol`	string	Trading pair symbol (`coin` is a deprecated alias)
`timestamp`	string	Snapshot time (UTC)
`open_interest`	string	Total open interest in contracts
`mark_price`	string	Mark price (drives PnL and liquidations)
`oracle_price`	string	Oracle price from the external feed
`mid_price`	string or null	Current mid price when available; may be omitted when unavailable
`day_ntl_volume`	string	24-hour notional volume (Hyperliquid core only)
`prev_day_price`	string	Price 24 hours ago (Hyperliquid core only)
`impact_bid_price`	string	Impact bid price used for liquidations (Hyperliquid core only)
`impact_ask_price`	string	Impact ask price used for liquidations (Hyperliquid core only)

All values are decimal strings. mark_price, oracle_price, and mid_price are three distinct prices: mark drives PnL and liquidations, oracle is the funding and liquidation reference, and mid is the book midpoint when present. day_ntl_volume, prev_day_price, impact_bid_price, and impact_ask_price appear on Hyperliquid core only. HIP-3 rows carry symbol, timestamp, open_interest, mark_price, and oracle_price; mid_price is conditional and may be omitted when unavailable. Lighter rows omit mid_price as well. Do not model the core-only fields as present on every venue family.

Stream it live

Open interest streams on Hyperliquid core (open_interest), HIP-4 (hip4_open_interest), and Lighter (lighter_open_interest). HIP-3 open interest is REST-only, and Spot has no open interest.

ws.send(JSON.stringify({ op: "subscribe", channel: "open_interest", symbol: "BTC" }));

Connection and reconnect handling live in the WebSocket tab; see WebSocket channels for the family matrix.

Export in bulk

For an open-interest history as files, use the oi export schema ($1/GB, $5 minimum), delivered as Parquet with ZSTD compression. Build a selection in the Data catalog; columns and coverage keys are on Export schemas.

Use Funding for the funding rate, Candles for price series, or Order books for live depth.

Get started

Market data

Get connected

Plans & limits

Get open interest

Request parameters

Response fields

Stream it live

Export in bulk

Next

​Get open interest

​Request parameters

​Response fields

​Stream it live

​Export in bulk

​Next

Get open interest

Request parameters

Response fields

Stream it live

Export in bulk

Next