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.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

The closest-delta contract + selection disclosure.

Bodyapplication/json

Example

{
    "data": {
        "symbol": "SPY",
        "snapshot_date": "string",
        "underlier_price": 0,
        "expiry": "string",
        "option_type": "C",
        "target_delta": 0.25,
        "delta_distance": 0,
        "contract": {
            "strike": 180,
            "last_price": 0,
            "bid": 0,
            "ask": 0,
            "volume": 0,
            "open_interest": 0,
            "implied_volatility": 0,
            "delta": 0,
            "gamma": 0,
            "theta": 0,
            "vega": 0,
            "rho": 0,
            "in_the_money": true,
            "contract_symbol": "string",
            "last_trade_date": "string",
            "option_type": "C",
            "greeks_source": "string"
        },
        "contracts_considered": 0,
        "dropped_unreliable_iv": 0,
        "dropped_missing_delta": 0
    },
    "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": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable