# Flow

Flow measures how unusually each stock is positioned (0–100 vs its own baseline), how flow is leaning, and how close its next catalyst is.

Flow is an information-only producer. Its numbers measure pressure, signed flow side, freshness, coverage limits, and catalyst timing. They are not direction calls, return forecasts, advice, entries, exits, or position sizing.

Vega content may cite measured fields and must remain separate from engine numbers, Signal Bus fields, API measurements, and calibration scorecards.

## Programmatic access

Flow exposes a read-only JSON API under /v1. Full contract and response shapes: /developers.
Copy-paste API quickstart: /developers/quickstart/.
MS/1 discovery: /.well-known/ms1 declares the pressure packet feed, catalyst-clock capability, source-health requirement, live hub key id 4e10b56a3124ac27, and unsigned detached-signature status.
Hub machine door: https://api.marketschema.com/.well-known/ms1 publishes the family capability and public-key discovery document.

Core surfaces:
- /v1/board — the measured universe (pressure, flow side, sleeves, next catalyst) with as-of and freshness
- /v1/ms1/pressure — MS/1 preview pressure packets with method, freshness, source_health, citations, gaps, SHA-256 integrity binding, and live hub-key metadata
- /v1/ms1/catalyst-clock — MS/1 preview catalyst-clock packets from family_catalyst_clock events, source_health, source provenance, affected measured names, SHA-256 integrity binding, and live hub-key metadata
- /v1/calendar — upcoming catalysts plus family_catalyst_clock.next[] with affected measured names and current pressure
- /v1/assets/{symbol} and /v1/reads/{symbol} — one name's focused read
- /v1/core-kpis, /v1/schema, /v1/scorecard, /v1/methodology

Snapshot (per-sleeve detail) surfaces:
- /v1/snapshot/event-risk, /v1/snapshot/volume, /v1/snapshot/squeeze-risk, /v1/snapshot/attention-divergence

History / time-axis surfaces (every number carries its own past):
- /v1/replay/pressure — pressure history
- /v1/archive/positioning/{symbol} — append-only positioning snapshots for one name
- /v1/replay/state-changes — the append-only state-change log

Numbers are measurements, never direction calls or advice.