OpenParable
Skip to content
← Back to skills

Alphagbm Iv Rank

Business
alphagbm-iv-rank

Alphagbm Iv Rank is an Agent Skill for business published in the AlphaGBM/skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/AlphaGBM/skills/blob/HEAD/skills/alphagbm-iv-rank/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/alphagbm-iv-rank, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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/<SYMBOL>

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/.

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.