The HIP-4
protocol map.
HIP-4 turns discrete outcomes into bounded contracts that trade on HyperCore. This reference separates observed protocol behavior from product-layer assumptions.
One outcome, several identifiers.
Hyperliquid defines an outcome encoding as 10 × outcome + side, where side is 0 or 1. That encoding appears in different wrappers depending on the API field. Treat them as typed identifiers, not interchangeable labels.
N = 10 × outcome + side
The shared numeric encoding. The side digit distinguishes the two tokens for an outcome.
#N
The outcome spot coin form returned in API and WebSocket market data.
+N
The outcome token name used in token and balance contexts.
100,000,000 + N
The integer outcome asset ID used when placing or cancelling orders.
These identity rules are documented in Hyperliquid's official Asset IDs reference.
Probability-shaped prices, CLOB execution.
An outcome price between 0 and 1 is commonly read as an implied probability, but it is still a market price. Depth, spread, inventory, and information all affect it. Orders execute through HyperCore's limit-order-book mechanics rather than a prediction-market AMM.
For a binary market, Yes and No are separate contracts. Do not assume a displayed pair will always sum to exactly 1.0 at executable size: bids, asks, spread, fees, and stale books matter.
Binary, multi-outcome, recurring.
Binary
Two mutually exclusive outcomes, commonly Yes and No.
Multi-outcome
Several mutually exclusive contracts representing a complete outcome set.
Recurring
A repeated template that creates new dated or thresholded markets over time.
Named event
A one-off event described through venue metadata and resolution rules.
Winning outcomes settle to 1.0.
When a market resolves, winning contracts settle at 1.0 and losing contracts at 0.0. The account balance updates automatically; there is no separate claim transaction in the normal HIP-4 settlement flow.
Resolution quality depends on the market's specification and settlement source. A short title is not enough. Traders should inspect the full question, cutoff time, source, tie/void behavior, and any dispute process exposed by the venue.
Mainnet trading and testnet launch are different tracks.
Curated outcome markets trade on mainnet. Permissionless Standard-mode deployment is currently a testnet workflow with stake, activation, venue-name, template, and rate constraints. Hyperliquid now documents outcome asset IDs, but no single public specification covers every observed creation, taxonomy, and settlement form. Production integrations should validate behavior against live API responses.
Primary sources
Asset IDs
Official outcome encoding, coin-name, token-name, and integer asset-ID forms.
Hyperliquid docsInfo endpoint
Official request and response reference for market and account information.
Live APIHyperliquid info API
Canonical API endpoint; requests require a documented JSON body.
DocumentationHyperliquid docs
Official protocol, trading, API, and operational documentation.