Docs/Getting started/Overview

Build markets that resolve from verified onchain state.

Predistate turns a deterministic contract read into a fully collateralized YES or NO market.

Predistate is a permissionless market protocol for outcomes read directly from smart contracts. Each market points to anIState implementation whose read() result decides whether YES wins. The core factory permits both registry-verified and unverified templates; the official API and web client expose only the exact implementations on their verified allowlist.

Create a price market Explore the contracts

Core model#

Explicit resolver trust, complete-set collateral, and permissionless settlement.

View lifecycle →

Create

Clone a verified or unverified state implementation and bind the market to immutable terms.

Trade

Place escrowed YES or NO limit orders above 0 and up to 1 collateral unit.

Resolve

Call the market's immutable state reader, then redeem the winning side.

Where to start#

Understand Price MarketsLearn what the pool, pair direction, call-time spot price, threshold, and deadline mean.Understand FDV MarketsLearn how exact token supply and authenticated call-time pool price combine into a quote-token valuation.Understand Total Supply MarketsLearn how token supply, decimals, minting, burning, and exact threshold boundaries determine settlement.Understand Balance MarketsTrack the exact ERC20 balance of any nonzero account and settle against a token-denominated threshold.Understand Lending Liquidation MarketsTrack one authenticated Aave V3 account or one borrower in an immutable Morpho Blue market.Read market pricesUse Buy now, Sell now, spread, midpoint, last trade, and mark price consistently.Follow resolutionSee exactly when check() or expire() settles YES or NO.Integrate contractsMap factory events to each market, state clone, and pair of outcome tokens.