HIP-4 Outcomes - Outcomes

Get HIP-4 outcome detail

Get a single HIP-4 outcome by outcome_id. Response uses Hip4OutcomeAggregate WITH aggregated_oi populated: latest both-sides OI snapshot including outcome_display_open_interest_contracts (sum of side0 + side1), paired_set_supply_contracts (paired-set notional), and side_supply_parity (whether side0 == side1 within tolerance). Currency is always USDH. Data available from May 2026.

get/v1/hyperliquid/hip4/outcomes/{outcome_id}

Request

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

Path parameters

outcome_idinteger required

Numeric outcome ID (integer >= 0). Each outcome has two sides: side 0 (Yes) and side 1 (No).

Response

HIP-4 outcome detail (with aggregated_oi)

successboolean

Example response

{
  "success": true,
  "data": {
    "name": "BTC ≥ 78213 by 2026-05-03 06:00 UTC",
    "description_raw": "class:priceBinary|underlying:BTC|expiry:20260503-0600|targetPrice:78213|period:1d",
    "class": "priceBinary",
    "underlying": "BTC",
    "expiry": "2026-05-03T06:00:00Z",
    "target_price": 78213,
    "period": "1d",
    "side_specs": [
      {
        "name": "Yes",
        "coin": "#0",
        "asset_id": 100000000
      }
    ],
    "status": "live",
    "source_seen_at": "2026-05-02T20:25:00Z",
    "aggregated_oi": {
      "side0_open_interest_contracts": 568048,
      "side1_open_interest_contracts": 568048,
      "outcome_display_open_interest_contracts": 1136096,
      "paired_set_supply_contracts": 568048,
      "side_supply_parity": true,
      "currency": "USDH",
      "as_of": "2026-05-02T20:27:21Z",
      "side0_as_of": "2026-05-02T20:27:21Z",
      "side1_as_of": "2026-05-02T20:27:21Z"
    }
  }
}

Changes

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