Zero to HYPE

T8 · Deploying markets

Outcome markets

HIP-4 templates, how markets settle, and what "TWAP" means at each venue. No tutorial covers settlement yet.

LessonChecked against the live API on 22 Oct 2026

Read first

The official docs for this track.

Then

Tutorials and write-ups worth your time.

Build

Hands-on work for this track.

What an outcome is

An outcome is a fully collateralised contract that settles somewhere in a fixed range. There’s no leverage and no liquidation.

On mainnet on Oct 21, 2026, three venues were deploying markets: out (Outcome, 159 live outcomes), txyz (trade[XYZ] Events, 64) and skew (Skew, 61). There was also Hyperliquid’s own recurring daily BTC market, which has no venue.

Every market comes from a template

Validators vote on templates, and deployers instantiate them. A template fixes the display text, the side names and a set of typed keywords, plus a semanticRestriction that says what markets made from it may mean. A market that contradicts its restriction can get its deployer slashed.

name:        template:binaryPrice
description: perp:BTC|priceDescription:BTC-USDC perp mark|seconds:60|threshold:85734|time:20261005-0600

The four price templates on mainnet:

Template Resolves
binaryPrice Yes if the {seconds}-second TWAP of {priceDescription} ending at {time} is above {threshold}. Strictly above: equal settles No.
priceTouch Yes as soon as that TWAP, taken over a rolling window, equals or crosses {target}, at any time before {time}. It can settle the moment it touches.
scalarPrice The Long side pays (price − low) / (high − low), clamped to between 0 and 1
binaryPriceExternal Like binaryPrice, priced from an outside feed. Settles at 0.5 if no settlement price can be verified within 24 hours.

How a market settles

The venue settles each outcome with an outcomeDeploy action (an L1 action, T3):

{
  "type": "outcomeDeploy",
  "venue": "ab",
  "operation": {
    "settleOutcome": {
      "outcome": 7,
      "settleFraction": "1",
      "details": "",
      "nameAndDescription": ["template:abc", "expiry:20260801-0600|target:100|underlying:ABC"],
      "sideNames": ["template:Over", "template:Under"]
    }
  }
}

To read a result, call {"type":"settledOutcome","outcome":7}. It returns null until the outcome settles, then its settleFraction and the original spec.

What “TWAP” means depends on the venue

The template says “TWAP of {priceDescription}” and stops there. It doesn’t say where the samples come from or how they’re weighted. hyperkeeper has recomputed every mainnet price market since Oct 8, 2026 and compared its answer with each venue’s settlement.

Venue Settles on Window Venue settled after (median) Match, Oct 8–17
out Mark price, sampled live 60 s 28 s 2,784 of 2,788
skew BTC trades, sampled live 90 s 51 s 440 of 444
txyz 1-minute candle closes 300 s 23 min (14 to 113) 180 of 180

What that taught us:

Running a venue

The deployer-actions page in the docs is still marked testnet-only, though the three venues above deploy and settle on mainnet.