Skip to content
TotalFinance

structure · wire operation

Dealer exposure & levels from an option chain

Compute dealer-positioning exposure (net GEX/DEX at spot) and key levels — call/put walls, zero-gamma flip, max pain, pin risk, and 0DTE/weekly/monthly OPEX walls — from an option chain. Each row needs `strike`, `expiry`, `type`, `openInterest`, and either `impliedVolatility` or `price` (IV is implied from price when omitted). Inferred from open interest and a sign convention (echoed in `assumptions.convention`, with its caveats as `model.limitation` warnings in `diagnostics.warnings`) — it does not know true dealer books.

totalfinance.structure.exposures
MCP tool name
totalfinance_structure_exposures
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
chainRequiredobject[]The option chain: one row per contract
spotRequirednumber—
riskFreeRateRequirednumberContinuously-compounded risk-free rate (decimal)
asOfRequirednumber | stringValuation instant — epoch ms or a zoned ISO datetime such as "2026-07-20T10:30:00-04:00". A bare YYYY-MM-DD is refused: a same-day option's value depends on the time of day. For an end-of-day mark use the 16:00 ET close (13:00 ET on early-close days).
dividendYieldOptionalnumber—
conventionRequired"callsPositivePutsNegative" | "dealerShortGamma"Dealer sign convention — REQUIRED, it decides the sign of every exposure number; echoed back with its limitations
styleRequired"american" | "european"Exercise style of every contract in the chain — REQUIRED (listed US equity options are 'american'); the library never defaults it
gammaUnitOptional"per1PercentMove" | "perPoint"GEX units: per1PercentMove (default, the specification formula) or perPoint
underlyingRequiredstringTicker symbol of the chain — REQUIRED, it names every contract
topStrikesOptionalintegerHow many top-|GEX| strikes to return (default 10)
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
spotRequirednumber—
atSpotRequiredobjectNet dealer exposure at spot
levelsRequiredobjectWalls, zero-gamma, max pain, pin risk, and OPEX walls
netDriftRequiredobjectGamma regime + pin/trend bias + charm/vanna flow
topStrikesRequiredobject[]Highest-|GEX| strikes, most concentrated first
assumptionsRequiredobjectEvery applied convention: the sign `convention`, gammaUnit, priceSource, minTimeToExpiry, defaultMultiplier, …
diagnosticsRequiredobjectWarnings, including the model limitations as `model.limitation` entries (positioning is estimated from OI + a sign convention, not true dealer books)
Complete JSON Schema

Loading…