Get HIP-4 open interest history

{ "success": true, "data": [ { "coin": "#0", "symbol": "#0", "outcome_id": 0, "side": 0, "timestamp": "2026-05-02T20:27:21Z", "open_interest": "568048", "mark_price": "0.6502", "mid_price": "0.65038" } ], "meta": { "count": 123, "next_cursor": "<string>", "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" } }

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://www.0xarchive.io/dashboard/

Path Parameters

symbol

string

required

HIP-4 coin id (e.g., 0 for outcome 0 Yes side, 1 for No side). The #-prefixed form (#0, #1) is also accepted.

Example:

"0"

Query Parameters

start

integer<int64>

Start timestamp in Unix milliseconds. Defaults to 24h ago.

end

integer<int64>

End timestamp in Unix milliseconds. Defaults to now.

cursor

integer<int64>

Cursor for pagination

limit

integer

default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000

interval

enum<string>

Aggregation interval. When omitted, returns raw ~1 min resolution data.

Available options:

5m,

15m,

30m,

1h,

4h,

1d

Response

Open interest data

API response wrapping an array of HIP-4 per-side open-interest records

success

boolean

Example:

true

data

object[]

Hide child attributes

data.coin

string

required

#-prefixed per-side coin identifier

Example:

"#0"

data.symbol

string

required

Same value as coin. Provided for consistency with other venues.

Example:

"#0"

data.outcome_id

integer<int64>

required

Numeric outcome identifier

Example:

0

data.side

enum<integer>

required

Side index: 0 = Yes, 1 = No

Available options:

0,

1

Example:

0

data.timestamp

string<date-time>

required

Snapshot timestamp (UTC)

Example:

"2026-05-02T20:27:21Z"

data.open_interest

string

required

Open interest in contracts (notional currency: USDH)

Example:

"568048"

data.mark_price

string | null

Implied probability in [0,1], NOT a USD price. Same field name as perps because Hyperliquid upstream uses markPx for both.

Example:

"0.6502"

data.mid_price

string | null

Mid price (probability in [0,1])

Example:

"0.65038"

Reference start

Generated schemas

Examples and responses

Data and operations

System

Legacy

Hyperliquid - Instruments

Hyperliquid - Order Book

Hyperliquid - Trades

Hyperliquid - Candles

Hyperliquid - Open Interest

Hyperliquid - Funding

Hyperliquid - Liquidations

Hyperliquid - Convenience

Lighter - Instruments

Lighter - Order Book

Lighter - Trades

Lighter - Candles

Lighter - Open Interest

Lighter - Funding

Lighter - Convenience

HIP-3 Builder Perps - Instruments

HIP-3 Builder Perps - Order Book

HIP-3 Builder Perps - Trades

HIP-3 Builder Perps - Candles

HIP-3 Builder Perps - Open Interest

HIP-3 Builder Perps - Funding

HIP-3 Builder Perps - Liquidations

HIP-3 Builder Perps - Convenience

Data Quality

Web3 Authentication

Hyperliquid - Orders

Hyperliquid - L4 Order Book

HIP-3 Builder Perps - Orders

HIP-3 Builder Perps - L4 Order Book

HIP-4 Outcomes - Outcomes

HIP-4 Outcomes - Instruments

HIP-4 Outcomes - Order Book

HIP-4 Outcomes - Trades

HIP-4 Outcomes - Open Interest

HIP-4 Outcomes - Convenience

HIP-4 Outcomes - Orders

Lighter - L3 Order Book

Hyperliquid Spot

Hyperliquid Spot - Candles

HIP-4 Outcomes - Candles

Documentation Index

Authorizations

Path Parameters

Query Parameters

Response