AlphaGBM IV Rank
Prerequisites
- Account authentication: Set env
ALPHAGBM_API_KEY (format agbm_xxxx...).
The live snapshot requires authentication even though it does not consume analysis credits.
- 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
| Metric |
Formula |
What It Means |
| IV Rank |
(Current IV - 52w Low) / (52w High - 52w Low) x 100 |
Where 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 today |
What % of the time IV was cheaper than now. 80 = IV was lower 80% of the time |
| Current IV |
30-day ATM implied volatility |
The market's current expectation of annualized movement |
| IV 52w High |
Highest 30-day IV in past 252 trading days |
Peak IV -- usually during selloffs or events |
| IV 52w Low |
Lowest 30-day IV in past 252 trading days |
Trough IV -- usually during calm, grinding markets |
| HV/IV Ratio |
Historical Volatility / Implied Volatility |
>1 means realized vol exceeds implied (IV may be cheap) |
IV Zones and Trading Signals
| IV Rank |
Zone |
What It Means |
Suggested Action |
| 80-100 |
Very High |
IV is near its annual peak -- options are expensive |
Sell premium: short strangles, iron condors, credit spreads |
| 60-80 |
High |
IV is elevated -- above-average option prices |
Lean toward selling, but selective; good for covered calls |
| 40-60 |
Moderate |
IV is in the middle -- neither cheap nor expensive |
Strategy-neutral; use directional view to decide |
| 20-40 |
Low |
IV is depressed -- options are cheap |
Lean toward buying; good for debit spreads, long straddles |
| 0-20 |
Very Low |
IV is near its annual trough -- options are very cheap |
Buy premium: long straddles, debit spreads, calendars (sell back month) |
API Endpoint
IV Snapshot (instant, no quota cost)
GET /api/options/snapshot/<SYMBOL>
Returns: ATM IV, IV Rank, HV 30d, VRP, VRP level. This endpoint does not consume analysis credits, but it still requires authentication.
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 Level |
Value |
Seller |
Buyer |
| very_high |
>=15% |
Very favorable |
Unfavorable |
| high |
5-15% |
Favorable |
Slightly unfavorable |
| normal |
+/-5% |
Neutral |
Neutral |
| low |
-15% to -5% |
Unfavorable |
Favorable |
| very_low |
<-15% |
Very unfavorable |
Very 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 Says |
What 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
Offline demo tickers are available without an API key: AAPL, NVDA, SPY, TSLA, META. They use bundled sample data from mock-data/; they are not live API access.
Related Skills
- 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.
1---2name: alphagbm-iv-rank-23description: 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".4---56# AlphaGBM IV Rank78## Prerequisites910- **Account authentication**: Set env `ALPHAGBM_API_KEY` (format `agbm_xxxx...`).11 The live snapshot requires authentication even though it does not consume analysis credits.12- **Base URL**: Default `https://alphagbm.zeabur.app`. Override with env `ALPHAGBM_BASE_URL`.1314## What This Skill Does1516Calculates **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?"*1718### Key Metrics1920| Metric | Formula | What It Means |21|--------|---------|---------------|22| **IV Rank** | (Current IV - 52w Low) / (52w High - 52w Low) x 100 | Where IV sits in its annual range. 0 = at the low, 100 = at the high |23| **IV Percentile** | % of days in past year where IV was lower than today | What % of the time IV was cheaper than now. 80 = IV was lower 80% of the time |24| **Current IV** | 30-day ATM implied volatility | The market's current expectation of annualized movement |25| **IV 52w High** | Highest 30-day IV in past 252 trading days | Peak IV -- usually during selloffs or events |26| **IV 52w Low** | Lowest 30-day IV in past 252 trading days | Trough IV -- usually during calm, grinding markets |27| **HV/IV Ratio** | Historical Volatility / Implied Volatility | >1 means realized vol exceeds implied (IV may be cheap) |2829### IV Zones and Trading Signals3031| IV Rank | Zone | What It Means | Suggested Action |32|---------|------|---------------|-----------------|33| **80-100** | Very High | IV is near its annual peak -- options are expensive | Sell premium: short strangles, iron condors, credit spreads |34| **60-80** | High | IV is elevated -- above-average option prices | Lean toward selling, but selective; good for covered calls |35| **40-60** | Moderate | IV is in the middle -- neither cheap nor expensive | Strategy-neutral; use directional view to decide |36| **20-40** | Low | IV is depressed -- options are cheap | Lean toward buying; good for debit spreads, long straddles |37| **0-20** | Very Low | IV is near its annual trough -- options are very cheap | Buy premium: long straddles, debit spreads, calendars (sell back month) |3839## API Endpoint4041### IV Snapshot (instant, no quota cost)4243```44GET /api/options/snapshot/<SYMBOL>45```4647Returns: ATM IV, IV Rank, HV 30d, VRP, VRP level. This endpoint does not consume analysis credits, but it still requires authentication.4849### Volatility Risk Premium (VRP)5051```52VRP = Implied Vol - Historical Vol53```5455VRP 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.5657| VRP Level | Value | Seller | Buyer |58|-----------|-------|--------|-------|59| very_high | >=15% | Very favorable | Unfavorable |60| high | 5-15% | Favorable | Slightly unfavorable |61| normal | +/-5% | Neutral | Neutral |62| low | -15% to -5% | Unfavorable | Favorable |63| very_low | <-15% | Very unfavorable | Very favorable |6465## How to Use6667### Input68- **Required**: Ticker symbol69- **Optional**: Lookback period (default 252 days), IV measure (30-day ATM, 60-day, or custom)7071### Output Structure7273```json74{75 "ticker": "AAPL",76 "price": 218.45,77 "iv_current": 28.5,78 "iv_rank": 42,79 "iv_percentile": 55,80 "iv_52w_high": 48.2,81 "iv_52w_low": 18.8,82 "iv_52w_mean": 30.1,83 "hv_30d": 25.2,84 "hv_iv_ratio": 0.88,85 "zone": "moderate",86 "signal": "No strong IV edge. Use directional conviction to choose strategy.",87 "iv_history": {88 "dates": ["2025-04-01", "2025-04-02", "..."],89 "iv_values": [32.1, 31.8, "..."],90 "hv_values": [28.5, 28.3, "..."]91 },92 "notable_events": [93 {"date": "2026-01-28", "iv": 48.2, "event": "Earnings spike"},94 {"date": "2025-08-05", "iv": 44.1, "event": "Market selloff"}95 ]96}97```9899### Example Queries100101| User Says | What Happens |102|-----------|-------------|103| "IV rank AAPL" | IV rank, percentile, zone, and trading signal |104| "Is NVDA IV high?" | IV rank + zone classification + comparison to 52w range |105| "IV percentile SPY" | Percentile with historical context |106| "Historical IV TSLA" | Full 252-day IV history with HV overlay |107| "Is volatility cheap for META?" | IV rank + HV/IV ratio + buy/sell recommendation |108| "Should I sell premium on QQQ?" | IV rank-based answer with suggested strategies |109110### Mock Data111112Offline demo tickers are available without an API key: AAPL, NVDA, SPY, TSLA, META. They use bundled sample data from `mock-data/`; they are not live API access.113114### Related Skills115- **alphagbm-vol-surface** -- Full 3D IV landscape across strikes and expirations116- **alphagbm-vol-smile** -- IV skew for a specific expiration117- **alphagbm-options-strategy** -- IV zone informs whether to buy or sell premium118- **alphagbm-options-score** -- IV attractiveness is a key scoring factor119120---121122*Powered by [AlphaGBM](https://alphagbm.com) -- Real-data options & research intelligence for traders and AI agents. 10K+ users.*
AlphaGBM