| name | alphagbm-vol-smile |
| description | 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 curve data, skew metrics (25-delta skew, risk reversal), and shape classification. Use when: analyzing put/call skew, checking if puts are expensive, understanding directional fear in options pricing, finding skew trades. Triggers on: "vol smile AAPL", "skew analysis NVDA", "put skew for TSLA", "is the smile steep for SPY", "volatility skew META", "smile shape for GOOGL".
|
| globs | ["mock-data/*.json"] |
AlphaGBM Volatility Smile
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
Analyzes the volatility smile (or skew) for a single expiration -- the curve of implied volatility plotted against strike prices. Reveals how the market prices tail risk, directional fear, and supply/demand imbalances across the options chain.
Key Outputs
| Output | What It Shows |
|---|
| Smile Curve | IV at each strike for the selected expiry -- the raw smile data |
| 25-Delta Skew | IV(25d put) - IV(25d call) -- the standard measure of directional skew |
| Risk Reversal | Price of 25d call minus 25d put -- a tradeable expression of skew |
| Smile Shape | Classification: normal, flat, reverse, winged, or smirk |
| Skew Percentile | Current skew vs. 252-day history -- is skew unusually steep or flat? |
What Smile Shape Means for Trading
| Shape | Description | Market Implication | Trade Ideas |
|---|
| Normal | OTM puts have higher IV than OTM calls | Standard hedging demand -- puts are expensive | Sell put spreads, buy call spreads |
| Flat | IV roughly equal across strikes | Low fear, balanced positioning | Neutral strategies (iron condors) |
| Reverse | OTM calls have higher IV than OTM puts | Upside speculation or short squeeze risk | Sell call spreads if overpriced |
| Winged | Both OTM puts and calls elevated | Expecting a large move, direction unknown | Sell straddles/strangles if IV is high |
| Smirk | Asymmetric -- one side significantly steeper | Directional fear concentrated on one side | Trade the steep side if skew is extreme |
API Endpoint
Volatility Smile
GET /api/options/tools/vol-smile/<SYMBOL>?expiry=2026-04-17
Query parameters:
- expiry (optional): Expiration date in
YYYY-MM-DD format. Defaults to nearest monthly expiry if omitted.
Returns the smile curve (strikes, IVs, deltas), skew metrics, shape classification, and skew percentile for the specified expiration.
How to Use
Input
- Required: Ticker symbol
- Optional: Expiration date (defaults to nearest monthly), moneyness range
Output Structure
{
"ticker": "AAPL",
"price": 218.45,
"expiry": "2026-04-18",
"dte": 20,
"smile": {
"strikes": [190, 195, 200, 205, 210, 215, 220, 225, 230, 235, 240],
"ivs": [42.1, 39.5, 36.8, 34.0, 31.5, 29.2,
Example Queries
| User Says | What Happens |
|---|
| "Vol smile AAPL" | Smile curve for nearest monthly expiry with skew metrics |
| "Skew analysis NVDA" | Full smile + skew percentile vs. history |
| "Put skew for TSLA" | Focuses on put-side IV, 25d skew, skew percentile |
| "Is the smile steep for SPY?" | Compares current 25d skew to 252-day range |
| "Smile shape GOOGL April expiry" | Shape classification for specified expiration |
Mock Data
Demo tickers available without API key: AAPL, NVDA, SPY, TSLA, META. Smile data uses realistic IV snapshots from mock-data/.
Related Skills
- alphagbm-vol-surface -- See the full 3D surface across all expirations
- alphagbm-iv-rank -- Is overall IV high or low vs. history?
- alphagbm-options-strategy -- Steep skew suggests certain spread strategies
- alphagbm-options-score -- Use skew insights to find better-scored contracts
Powered by AlphaGBM -- Real-data options & research intelligence for traders and AI agents. 10K+ users.
