Skip to content
TotalFinance

structure · wire operation

Classify options flow (sweeps / blocks / spreads)

Classify option prints into aggressor-side flow: sweeps (multi-print bursts, venue-verified when exchange codes are supplied), blocks, and multi-leg spreads. Aggressor side is NBBO-estimated (Lee–Ready style) — the honest caveats ride diagnostics.warnings as `model.limitation` entries (mirrored as `limitations` strings for quick reading); nothing is presented as exchange-confirmed unless it is.

totalfinance.structure.flow
MCP tool name
totalfinance_structure_flow
Pack / profiles
structure / default, full
Default discovery
Included in the default tool set
Required capabilities
None
Effects / authorization
none / none
Cost / cancellation
small / Do not assume inline interruption
Handle-eligible inputs
None
Idempotency
not-applicable

Input schema

FieldTypeMeaning
tradesRequiredobject[]Option prints, any order (sorted internally)
underlyingRequiredstringTicker of the prints — REQUIRED, it names every contract
styleRequired"american" | "european"Exercise style of the printed contracts — REQUIRED (listed US equity options are 'american'); the library never defaults it
multiplierOptionalnumberContract multiplier (default 100)
blockMinSizeOptionalnumberMin contracts for a block (default 100)
blockMinPremiumOptionalnumberMin premium $ for a block (default 100,000)
maxDetailsOptionalintegerMax sweeps/spreads returned in detail (default 25 each)
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
countsRequiredobjecttrades/sweeps/spreads/buy/sell/unknown totals
sweepsRequiredany[]Detected sweeps (capped by maxDetails)
spreadsRequiredany[]Detected multi-leg spreads (capped)
assumptionsRequiredobjectThe rules/windows the analysis ran under
diagnosticsRequiredobjectWarnings, including the heuristic caveats as `model.limitation` entries
limitationsRequiredstring[]Convenience view: the `model.limitation` messages from diagnostics.warnings (diagnostics is the source of truth)
Complete JSON Schema

Loading…