HIP-4 Outcomes - Outcomes

List HIP-4 outcomes

List HIP-4 outcome markets (one row per outcome, both sides combined). Optional is_settled filter. Cursor pagination. Response uses Hip4OutcomeAggregate and OMITS the aggregated_oi field. Use /outcomes/{outcome_id} to fetch a single outcome with aggregated_oi populated. Data available from May 2026.

get/v1/hyperliquid/hip4/outcomes

Request

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

Query parameters

is_settledboolean

Filter by settlement status. Omit to return both live and settled outcomes.

cursorstring

Cursor for pagination (use the value from previous response's next_cursor)

limitinteger

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

Response

List of HIP-4 outcomes (without 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.