| name | alphagbm-options-score |
| description | Score and rank options contracts for any ticker using AlphaGBM's multi-factor scoring model (liquidity, IV attractiveness, Greeks balance, risk/reward). Returns scored option chains with the best contracts highlighted. Use when: evaluating which option to trade, finding the best strike/expiry, ranking options by quality. Triggers on: "score AAPL options", "best options for NVDA", "which TSLA call should I buy", "option chain for SPY", "rank META puts".
|
| globs | ["mock-data/*.json"] |
AlphaGBM Options Score
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
Scores every option contract in a chain using a multi-factor model across 4 strategy types, so you instantly know which contracts have the best risk/reward profile.
Strategy Scoring Models
Sell Put Weights
| Factor | Weight | Description |
|---|
| premium_yield | 20% | Annualized return from premium |
| support_strength | 20% | Proximity to key support levels |
| safety_margin | 15% | ATR-adjusted OTM buffer |
| trend_alignment | 15% | Downtrend = 100, Uptrend = 30 |
| probability_profit | 15% | Black-Scholes prob of expiring OTM |
| liquidity | 10% | Volume + OI + spread |
| time_decay | 5% | 20-45 DTE optimal |
Sell Call Weights
| Factor | Weight |
|---|
| premium_yield | 20% |
| resistance_strength | 20% |
| trend_alignment | 15% |
| upside_buffer | 15% |
| liquidity | 10% |
| is_covered | 10% |
| time_decay | 5% |
| overvaluation | 5% |
Buy Call Weights
| Factor | Weight |
|---|
| bullish_momentum | 25% |
| breakout_potential | 20% |
| value_efficiency | 20% |
| volatility_timing | 15% |
| liquidity | 10% |
| time_optimization | 10% |
Buy Put Weights
| Factor | Weight |
|---|
| bearish_momentum | 25% |
| support_break | 20% |
| value_efficiency | 20% |
| volatility_expansion | 15% |
| liquidity | 10% |
| time_value | 10% |
Score Scale
- 80-100: Exceptional — top-tier opportunity
- 60-79: Strong — good trade candidate
- 40-59: Average — proceed with caution
- 0-39: Poor — avoid unless hedging
Risk-Return Profiles
| Style | Typical Win Rate | Typical Return |
|---|
| steady_income | 65-80% | 1-5%/month |
| balanced | 40-55% | 50-200% |
| high_risk_high_reward | 20-40% | 2-10x |
| hedge | 30-50% | 0-1x |
API Endpoints
Get Option Expirations
GET /api/options/expirations/<SYMBOL>
Option Chain Analysis -- Synchronous
POST /api/options/chain-sync
Content-Type: application/json
{"symbol": "AAPL", "expiry_date": "2026-04-17"}
Add ?compact=true for condensed response.
Response includes for each of 4 strategies (Sell Put, Sell Call, Buy Call, Buy Put):
- Top 10 recommendations sorted by score (0-100)
- Score breakdown: premium_yield, support/resistance_strength, safety_margin, trend_alignment, probability_profit, liquidity, time_decay
- ATR safety info (safety_ratio, atr_multiples, is_safe)
- Risk-return profile: style, risk_level, win_probability
- Trend analysis: direction, strength, alignment score
Option Chain Analysis -- Async
POST /api/options/chain-async
Content-Type: application/json
{"symbol": "TSLA", "expiry_date": "2026-04-17"}
Returns {"task_id": "uuid"}. Poll with: GET /api/tasks/<task_id>.
Enhanced Single-Option Analysis -- Sync
POST /api/options/enhanced-sync
Content-Type: application/json
{"symbol": "AAPL", "option_identifier": "AAPL260417C00190000"}
Enhanced Single-Option Analysis -- Async
POST /api/options/enhanced-async
Content-Type: application/json
{"symbol": "AAPL", "option_identifier": "AAPL260417C00190000"}
Reverse Score
Score a specific contract from known parameters:
POST /api/options/reverse-score
Content-Type: application/json
{"symbol": "AAPL", "option_type": "CALL", "strike": 190, "expiry_date": "2026-02-16", "option_price": 2.50, "implied_volatility": 28}
Batch Chain Analysis
POST /api/options/chain/batch
Content-Type: application/json
{"symbols": ["AAPL", "NVDA"], "expiries": ["2026-04-17", "2026-05-15"]}
Max 3 symbols x 2 expiries per request.
IV Snapshot (instant, no quota cost)
GET /api/options/snapshot/<SYMBOL>
Returns: ATM IV, IV Rank, HV 30d, VRP, VRP level.
Daily Recommendations (no auth required)
GET /api/options/recommendations?count=5
Typical Workflow
- Get expirations:
GET /api/options/expirations/AAPL
- Quick IV check:
GET /api/options/snapshot/AAPL (free, no quota)
- Run chain analysis:
POST /api/options/chain-sync with symbol + expiry
- Drill into a specific contract:
POST /api/options/enhanced-sync with option_identifier
- Compare across tickers:
POST /api/options/chain/batch for multi-symbol analysis
Quota
- Free: 1 options analysis/day
- Plus: 1,000/month
- Pro: 5,000/month
- Snapshot and recommendations endpoints cost nothing.
Output Formatting Tips
- Scores are 0-100; present top picks in a table sorted by score descending.
- Always show the score breakdown factors so users understand why a contract scored well.
- Highlight ATR safety info (is_safe flag) prominently for sell strategies.
- Include the risk-return style label (steady_income, balanced, etc.) for quick context.
Example Queries
| User Says | What Happens |
|---|
| "Score AAPL options" | Full chain with scores, top picks highlighted |
| "Best NVDA call to buy" | Filtered to calls, sorted by score descending |
| "TSLA puts for next Friday" | Filtered by expiry + type |
| "Which SPY option has the best risk/reward?" | Sorted by risk_reward factor |
Mock Data
Demo tickers available without API key: AAPL, NVDA, SPY, TSLA, META. Uses realistic option chain snapshots from mock-data/.
Related Skills
- alphagbm-stock-analysis -- Analyze the underlying stock first
- alphagbm-options-strategy -- Build multi-leg strategies with top-scored contracts
- alphagbm-greeks -- Deep-dive into Greeks for a specific contract
- alphagbm-vol-surface -- See if IV is cheap or expensive across strikes
Powered by AlphaGBM -- Real-data options & research intelligence. 10K+ users.
