Data & analysis

Alphagbm Iv Rank

Try it

IV Rank and IV Percentile analysis showing where current implied volatility stands relative to its 252-day history. Returns IV rank (0-100), IV percentile (0...

What it does

IV Rank and IV Percentile analysis showing where current implied volatility stands relative to its 252-day history. Returns IV rank (0-100), IV percentile (0-100), IV history data, and trading signals based on IV zone. Use when: deciding whether to buy or sell premium, checking if IV is high or low, timing volatility trades, screening for IV extremes. Triggers on: "IV rank AAPL", "is NVDA IV high", "IV percentile SPY", "historical IV TSLA", "is volatility cheap for META", "IV rank scan", "should I sell premium".

The skill document

AlphaGBM IV Rank

Prerequisites

  • API Key: Set env ALPHAGBM_API_KEY (format agbm_xxxx...).
  • Base URL: Default https://alphagbm.zeabur.app. Override with env ALPHAGBM_BASE_URL.

What This Skill Does

Calculates IV Rank and IV Percentile for any ticker, placing current implied volatility in historical context. Answers the key question: "Is IV high or low right now, and what should I do about it?"

Key Metrics

MetricFormulaWhat It Means
IV Rank(Current IV - 52w Low) / (52w High - 52w Low) x 100Where IV sits in its annual range. 0 = at the low, 100 = at the high
IV Percentile% of days in past year where IV was lower than todayWhat % of the time IV was cheaper than now. 80 = IV was lower 80% of the time
Current IV30-day ATM implied volatilityThe market's current expectation of annualized movement
IV 52w HighHighest 30-day IV in past 252 trading daysPeak IV -- usually during selloffs or events
IV 52w LowLowest 30-day IV in past 252 trading daysTrough IV -- usually during calm, grinding markets
HV/IV RatioHistorical Volatility / Implied Volatility>1 means realized vol exceeds implied (IV may be cheap)

IV Zones and Trading Signals

IV RankZoneWhat It MeansSuggested Action
80-100Very HighIV is near its annual peak -- options are expensiveSell premium: short strangles, iron condors, credit spreads
60-80HighIV is elevated -- above-average option pricesLean toward selling, but selective; good for covered calls
40-60ModerateIV is in the middle -- neither cheap nor expensiveStrategy-neutral; use directional view to decide
20-40LowIV is depressed -- options are cheapLean toward buying; good for debit spreads, long straddles
0-20Very LowIV is near its annual trough -- options are very cheapBuy premium: long straddles, debit spreads, calendars (sell back month)

API Endpoint

IV Snapshot (instant, no quota cost)

GET /api/options/snapshot/

Returns: ATM IV, IV Rank, HV 30d, VRP, VRP level. This endpoint is free and does not count against your analysis quota.

Volatility Risk Premium (VRP)

VRP = Implied Vol - Historical Vol

VRP measures the gap between what the market expects (IV) and what actually happens (HV). It is a key signal for whether to sell or buy premium.

VRP LevelValueSellerBuyer
very_high>=15%Very favorableUnfavorable
high5-15%FavorableSlightly unfavorable
normal+/-5%NeutralNeutral
low-15% to -5%UnfavorableFavorable
very_low<-15%Very unfavorableVery favorable

How to Use

Input

  • Required: Ticker symbol
  • Optional: Lookback period (default 252 days), IV measure (30-day ATM, 60-day, or custom)

Output Structure

{
  "ticker": "AAPL",
  "price": 218.45,
  "iv_current": 28.5,
  "iv_rank": 42,
  "iv_percentile": 55,
  "iv_52w_high": 48.2,
  "iv_52w_low": 18.8,
  "iv_52w_mean": 30.1,
  "hv_30d": 25.2,
  "hv_iv_ratio": 0.88,
  "zone": "moderate",
  "signal": "No strong IV edge. Use directional conviction to choose strategy.",
  "iv_history": {
    "dates": ["2025-04-01", "2025-04-02", "..."],
    "iv_values": [32.1, 31.8, "..."],
    "hv_values": [28.5, 28.3, "..."]
  },
  "notable_events": [
    {"date": "2026-01-28", "iv": 48.2, "event": "Earnings spike"},
    {"date": "2025-08-05", "iv": 44.1, "event": "Market selloff"}
  ]
}

Example Queries

User SaysWhat Happens
"IV rank AAPL"IV rank, percentile, zone, and trading signal
"Is NVDA IV high?"IV rank + zone classification + comparison to 52w range
"IV percentile SPY"Percentile with historical context
"Historical IV TSLA"Full 252-day IV history with HV overlay
"Is volatility cheap for META?"IV rank + HV/IV ratio + buy/sell recommendation
"Should I sell premium on QQQ?"IV rank-based answer with suggested strategies

Mock Data

Demo tickers available without API key: AAPL, NVDA, SPY, TSLA, META. IV history uses realistic 252-day data from mock-data/.

  • alphagbm-vol-surface -- Full 3D IV landscape across strikes and expirations
  • alphagbm-vol-smile -- IV skew for a specific expiration
  • alphagbm-options-strategy -- IV zone informs whether to buy or sell premium
  • alphagbm-options-score -- IV attractiveness is a key scoring factor

Powered by AlphaGBM -- Real-data options & research intelligence for traders and AI agents. 10K+ users.

Related skills

Set price, IV, or activity-based alerts with contextual notifications. Alert types include IV rank threshold crossing, price support/resistance breaks, unusu...

Full earnings-season IV analysis: historical crush, implied move forecast, IV Rank strategy tag, and a priced Iron Condor quote ready to trade. Triggers: "ea...

3D volatility surface analysis mapping implied volatility across strikes (moneyness) and expirations. Shows whether options are cheap or expensive at every p...

Monitor a list of tickers for key changes in price, IV rank, unusual activity, earnings dates, and score changes. Supports custom watchlists and a default "h...

2D volatility smile and skew analysis for a single expiration date. Maps IV across strikes to reveal put skew, call skew, and smile shape. Returns smile curv...

Score and rank options contracts for any ticker using AlphaGBM's multi-factor scoring model (liquidity, IV attractiveness, Greeks balance, risk/reward). Retu...

1 stars