Latest or dated options snapshot for one underlier
Single underlier options snapshot at the latest cycle (default) or at a specific calendar date via ?date=YYYY-MM-DD. Returns the full payload: underlier spot price, ATM IV, per-expiry calls/puts contracts with Greeks (Black-Scholes for the Sugra Finance feed, native for the VIX volatility feed), per-expiry aggregates (volume / OI / put-call ratios / max-pain strike), and precomputed IV surface + term structure. Passing ?expiry=YYYY-MM-DD narrows the response to a single expiry block; an unmatched expiry returns 404. Returns 410 Gone when the symbol is flagged delisted_candidate by the upstream cycle.
Path parameters
Underlier ticker.
Underlier ticker.
Query parameters
Optional snapshot date (YYYY-MM-DD). Defaults to the latest cycle.
Optional snapshot date (YYYY-MM-DD). Defaults to the latest cycle.
Optional expiry filter (YYYY-MM-DD). Narrows to a single expiry block.
Optional expiry filter (YYYY-MM-DD). Narrows to a single expiry block.
Response
Latest or dated options snapshot payload.
Example response
{
"data": {
"symbol": "AAPL",
"snapshot_date": "2026-05-19",
"snapshot_taken_at": "2026-05-19T22:51:23Z",
"manifest_version": "1715906400",
"greeks_source": "yahoo_iv_bs_calc_zero_div",
"data_source": "yahoo_options_v7",
"license_attribution": "Data sourced via Sugra Finance",
"risk_free_rate_used": 0.045,
"underlier_price": 187.45,
"underlier_iv_30d_atm": 0.2231,
"expiries": [
{
"expiration_date": "2026-06-06",
"days_to_expiration": 18,
"calls": [
{
"strike": 180,
"last_price": 8.45,
"volume": 12450,
"open_interest": 45230,
"implied_volatility": 0.2412,
"contract_symbol": "AAPL260606C00180000",
"last_trade_date": "2026-05-19T20:00:00Z",
"option_type": "C",
"greeks_source": "yahoo_iv_bs_calc_zero_div"
}
],
"puts": [
{
"strike": 180,
"last_price": 8.45,
"volume": 12450,
"open_interest": 45230,
"implied_volatility": 0.2412,
"contract_symbol": "AAPL260606C00180000",
"last_trade_date": "2026-05-19T20:00:00Z",
"option_type": "C",
"greeks_source": "yahoo_iv_bs_calc_zero_div"
}
]
}
]
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}