Compare two expirations without treating snapshots as fills
A long calendar pairs a short earlier option with a long later option at the same strike and of the same type. Load a ticker, choose two returned expirations in order, and select a common strike. The request loads at most 250 contracts of one type. Missing later expirations or strikes can be a sampling limit, not proof that no contract exists.
Inspect prices and missing fields
The entry difference is the back daily-bar close minus the front daily-bar close. Those observations are not executable bid/ask prices and may have different update times. Standard 100-share contracts are required. Missing prices or positive back-month IV block the curve; missing Greeks remain unavailable.
Understand the scenario calculation
At front expiration, the short leg is assigned its intrinsic value. The remaining long option is valued with European Black-Scholes using its reported IV unchanged, a fixed 5% annual interest rate, zero dividends and the calendar-day gap between expirations divided by 365. P&L is 100 times the back theoretical value minus the front intrinsic value minus the entry debit. This is one spread; there is no quantity control.
Separate a displayed difference from an investment conclusion
The IV difference is back minus front, expressed in percentage points. Theta and vega differences are per-share snapshot sensitivities. Their signs can change. An apparent IV gap can reflect scheduled events, stale observations or differing uncertainty at the two maturities. It does not alone show which option is cheap or whether the spread will earn money.
Read the chart as a limited sensitivity analysis
The grid extends 15% beyond the lower and higher of spot and strike. Its highest and lowest P&L values are sampled extrema, not global maxima or a guaranteed loss limit. No probability of profit, exact breakeven solver, volatility-shift control, commission, dividend, early-exercise, assignment or funding model is included. American-style settlement can leave a position in the underlying even when the expiration diagram looks contained.
See the Massive snapshot fields and pagination documentation. Verify contract terms and available quotes before making a separate trading decision. This educational model does not provide investment advice or execution.