Field notes
Documentation · how State.OS works
Notes from the field.
Full documentation on how State.OS reads, normalizes and displays market state.
State.OS is a read-only market-structure explorer. These notes explain the terms it uses and how each page works — pick a topic from the left, or start with a section below.
Overview
Concepts
Normalization
Why a reference price and a pool price aren't the same number until you scale them onto one axis.
Pool dispersion
How far the widest pool price sits from the tightest, measured at the same instant.
Liquidity depth
How much size a pool can absorb near its quoted price before that price moves.
Unit multipliers
Why some assets report a raw quantity that has to be scaled before it matches a displayed price.
Confidence score
How State.OS summarizes agreement across pools into a single percentage.
Product
Markets directory
How the references table, divergence matrix and metric cards fit together.
Topology graph
How the asset-and-pool node graph encodes state, liquidity and freshness.
Replay
What the recorded snapshots show, and why Replay never predicts forward.
Wallet & chain
What connecting a wallet changes, and what it deliberately doesn't.