Precomputed IV surface + term structure for one underlier

Returns the precomputed implied-volatility surface (strike x expiry grid as call_iv_skew + put_iv_skew per expiry) and the ATM-IV term structure for the requested underlier. Computed during the ingest cycle and stored on the snapshot payload (saves API hot-path compute). Defaults to the latest cycle; pass ?date=YYYY-MM-DD to read a historical surface. date must lie within the 90-day retention window.

Responses

🟢200OK

application/json

IV surface payload.

Bodyapplication/json

Example

{
    "data": {
        "symbol": "string",
        "snapshot_date": "string",
        "underlier_price": 0,
        "surface": [
            {
                "expiration_date": "string",
                "days_to_expiration": 0,
                "atm_iv": 0,
                "atm_strike": 0,
                "call_iv_skew": [
                    {
                        "strike": 0,
                        "iv": 0,
                        "moneyness": 0
                    }
                ],
                "put_iv_skew": [
                    {
                        "strike": 0,
                        "iv": 0,
                        "moneyness": 0
                    }
                ]
            }
        ],
        "term_structure": [
            {
                "days_to_expiration": 0,
                "atm_iv": 0
            }
        ],
        "greeks_source": "string"
    },
    "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

Precomputed IV surface + term structure for one underlier

Request

Request Code Samples

Responses