IV rank + percentile of current ATM IV vs the snapshot history
Ranks the CURRENT nearest-expiry ATM IV against the symbol's own dated snapshot history, so the consumer no longer has to accumulate and store that history client-side. window counts OBSERVATIONS (dated snapshots that yielded a gated ATM IV), default 252 - the annual convention - but the dated store retains 90 days, so observations_found discloses what the rank actually rested on. iv_rank is min-max scaled (null when the window's range is degenerate); iv_percentile is the share of observations at or below current. Fewer than 2 observations is a 503 insufficient_history, never a rank fabricated from one point. Error codes match /snapshot.
Path parameters
Underlier ticker.
Underlier ticker.
Query parameters
Window size in observations (30..504, default 252). Bounded in practice by the 90-day dated-snapshot retention; observations_found reports the reality.
Window size in observations (30..504, default 252). Bounded in practice by the 90-day dated-snapshot retention; observations_found reports the reality.
Response
IV rank payload.
Example response
{
"data": {
"symbol": "SPY"
},
"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"
]
}
}