HIP-4 Outcomes - Open Interest

Get HIP-4 open interest history

Get historical per-side open interest data for a HIP-4 outcome side. Mirrors HIP-3 OI shape plus outcome_id and side fields. Display/paired/parity aggregates (sum across both sides, paired-set supply, side-supply parity check) live on /outcomes/{outcome_id}.aggregated_oi, NOT on this endpoint. Note: mark_price for HIP-4 outcomes is an implied probability in [0,1], not a USD price; same field name as perps because Hyperliquid upstream uses markPx for both. Data available from May 2026.

get/v1/hyperliquid/hip4/openinterest/{symbol}

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/hyperliquid/hip4/openinterest/{symbol}
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:0

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

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults to 24h ago. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limitinteger

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

interval'1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '1d'

Aggregation interval. When omitted, returns raw ~10 sec outcome-side open-interest updates.

Response

Open interest data

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "coin": "#0",
      "symbol": "#0",
      "timestamp": "2026-05-02T20:27:21Z",
      "open_interest": "568048",
      "mark_price": "0.6502",
      "mid_price": "0.65038"
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.