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
| Field | Type | Meaning |
|---|---|---|
chainRequired | object[] | The option chain: one row per contract |
spotRequired | number | — |
riskFreeRateRequired | number | Continuously-compounded risk-free rate (decimal) |
asOfRequired | number | string | Valuation 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). |
dividendYieldOptional | number | — |
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 |
underlyingRequired | string | Ticker symbol of the chain — REQUIRED, it names every contract |
topStrikesOptional | integer | How many top-|GEX| strikes to return (default 10) |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
spotRequired | number | — |
atSpotRequired | object | Net dealer exposure at spot |
levelsRequired | object | Walls, zero-gamma, max pain, pin risk, and OPEX walls |
netDriftRequired | object | Gamma regime + pin/trend bias + charm/vanna flow |
topStrikesRequired | object[] | Highest-|GEX| strikes, most concentrated first |
assumptionsRequired | object | Every applied convention: the sign `convention`, gammaUnit, priceSource, minTimeToExpiry, defaultMultiplier, … |
diagnosticsRequired | object | Warnings, including the model limitations as `model.limitation` entries (positioning is estimated from OI + a sign convention, not true dealer books) |
Complete JSON Schema
Loading…