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
| Field | Type | Meaning |
|---|---|---|
tradesRequired | object[] | Option prints, any order (sorted internally) |
underlyingRequired | string | Ticker 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 |
multiplierOptional | number | Contract multiplier (default 100) |
blockMinSizeOptional | number | Min contracts for a block (default 100) |
blockMinPremiumOptional | number | Min premium $ for a block (default 100,000) |
maxDetailsOptional | integer | Max sweeps/spreads returned in detail (default 25 each) |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
countsRequired | object | trades/sweeps/spreads/buy/sell/unknown totals |
sweepsRequired | any[] | Detected sweeps (capped by maxDetails) |
spreadsRequired | any[] | Detected multi-leg spreads (capped) |
assumptionsRequired | object | The rules/windows the analysis ran under |
diagnosticsRequired | object | Warnings, including the heuristic caveats as `model.limitation` entries |
limitationsRequired | string[] | Convenience view: the `model.limitation` messages from diagnostics.warnings (diagnostics is the source of truth) |
Complete JSON Schema
Loading…