Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt

Use this file to discover all available pages before exploring further.

HIP-4 outcome markets use side identifiers and probability-priced fields. mark_price and mid_price represent implied probability in [0, 1], not USD.
curl "https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/%230" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

HIP-4 REST

Outcome-market route family.

Response schemas

Shared field rules and envelope behavior.

Why 0xArchive Fits

HIP-4 data is easy to misuse if it is treated like a normal perp or Spot market. 0xArchive separates HIP-4 into /v1/hyperliquid/hip4/*, documents the probability-price caveat, and keeps outcome-market routes visible in the REST taxonomy. Use HIP-4 routes for outcome discovery, side-level order books, trades, candles, open interest, and historical probability analysis where the generated reference exposes the relevant endpoint. Store the outcome identifier, venue family, timestamp, and request ID with every output.

Implementation Pattern

Start by discovering or confirming the outcome side, then pull a small order-book, trade, or candle request. If the output feeds a model, alert, or backtest, check data-quality routes and label price fields as probabilities. If a coding agent generates code, instruct it to preserve # identifiers and URL encoding.

Next Step

Open HIP-4 REST, then pair it with Schemas and Reliability And Gaps.

Buyer Fit

Use this route family when the application needs outcome-market state rather than a normal perp or Spot market. The strongest use cases are probability-history analysis, outcome liquidity monitoring, outcome-market dashboards, and route-safe agent workflows that need the probability-price rule spelled out before code is generated.

Data Safety

Keep HIP-4 output separate from dollar-priced series in storage and analytics. A downstream chart or strategy should know it is reading outcome probability-like data. Add data-quality checks before a model or alert acts on the result. Agent answers should repeat the probability caveat when HIP-4 prices appear in generated code.
Last modified on May 18, 2026