Open interest

Open interest is the outstanding contract size exposed by a route family, plus that family’s applicable price and identity fields. Hyperliquid core, HIP-3, HIP-4, and Lighter serve open interest; Spot does not. HIP-4 outcome-side OI and Lighter OI are route-specific; check coverage metadata for the selected symbol and window.

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: `5m`, `15m`, `30m`, `1h`, `4h`, or `1d`. When omitted, the route returns raw source updates at the family-specific cadence.
`limit`	query	integer	No	Max results. Default 100, maximum 1000.
`cursor`	query	integer	No	Pagination cursor from `meta.next_cursor`; pass the returned value unchanged.

{
  "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": "12345678-1234-4123-8123-123456789012" }
}

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; on HIP-4 this is an implied probability, not a liquidation mark
`oracle_price`	string	Oracle price when that family supplies one; not applicable to HIP-4 outcome-side OI
`mid_price`	string or null	Current mid price when available; may be omitted when unavailable
`outcome_id`	integer	HIP-4 outcome identifier; omitted for the other families
`side`	integer	HIP-4 outcome side; omitted for the other families
`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)

Numeric market values are decimal strings. Where a family returns all three, mark_price, oracle_price, and mid_price are distinct: mark drives PnL and liquidations, oracle is the funding and liquidation reference, and mid is the book midpoint when present. Do not manufacture a missing oracle field for HIP-4. 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. HIP-4 rows carry outcome_id, side, mark_price, mid_price, and outcome-side open_interest, with no oracle_price. Lighter rows omit mid_price. Do not model one family’s fields as present on every family.

Stream or replay it

Open interest streams live on Hyperliquid core (open_interest). Lighter current open interest uses REST, and lighter_open_interest supports historical WebSocket replay but not live subscriptions through the 0xArchive WebSocket. Historical data is also available through REST and exports. Stored hip4_open_interest history remains replayable; current HIP-4 open-interest reads use REST. 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 ($0.50/GB, $2.50 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.

Start

API

Exports

Data types

Venues

Data rights

Get open interest

Request parameters

Response fields

Stream or replay it

Export in bulk

Next

​Get open interest

​Request parameters

​Response fields

​Stream or replay it

​Export in bulk

​Next

Get open interest

Request parameters

Response fields

Stream or replay it

Export in bulk

Next