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

startinteger

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

endinteger

End timestamp in Unix milliseconds. Defaults to now.

cursorinteger

Cursor for pagination

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"
    }
  ]
}

Changes

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