Select one contract by closest delta (no full-chain download)
Returns the single contract whose delta is CLOSEST to the requested target on the requested expiry - the 'which strike is the 25-delta call' answer as one small response instead of the ~256 KB full chain plus a client-side search. Delta is SIGNED: positive selects from calls, negative from puts; the optional right parameter must agree with the sign when given. Contracts whose implied volatility fails the shared plausibility gate (including the upstream's literal 0.0 no-data marker, API-1.8) or that carry no usable delta are EXCLUDED before selection and disclosed in the dropped_* counters, so a gated chain can never silently select an empty contract. Error codes match /snapshot: unknown_symbol, expiry_not_in_snapshot, snapshot_not_available. unknown_symbol covers two different situations, told apart by the reason field of the error body: a symbol that does not resolve on this platform, and one that resolves but is not among the underliers options data is collected for. The body names the size of that roster and the endpoint listing it.
Path parameters
Underlier ticker.
Underlier ticker.
Query parameters
Expiry to select from (YYYY-MM-DD). Required - delta targeting is per-expiry.
Expiry to select from (YYYY-MM-DD). Required - delta targeting is per-expiry.
Target delta, SIGNED: calls in (0, 1), puts in (-1, 0). 0.25 = the 25-delta call; -0.25 = the 25-delta put.
Target delta, SIGNED: calls in (0, 1), puts in (-1, 0). 0.25 = the 25-delta call; -0.25 = the 25-delta put.
Optional side. When given it must agree with the delta sign; when omitted the sign decides.
Optional side. When given it must agree with the delta sign; when omitted the sign decides.
Optional snapshot date (YYYY-MM-DD). Defaults to the latest cycle.
Optional snapshot date (YYYY-MM-DD). Defaults to the latest cycle.
Response
The closest-delta contract + selection disclosure.
Example response
{
"data": {
"symbol": "SPY",
"option_type": "C",
"target_delta": 0.25,
"contract": {
"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"
]
}
}