Alphagbm Options Score

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 | |--------|--------|-------------| | premiumyield | 20% | Annualized return from premium | | supportstrength | 20% | Proximity to key support levels | | safetymargin | 15% | ATR-adjusted OTM buffer | | trendalignment | 15% | Downtrend = 100, Uptrend = 30 | | probabilityprofit | 15% | Black-Scholes prob of expiring OTM | | liquidity | 10% | Volume + OI + spread | | timedecay | 5% | 20-45 DTE optimal |

Sell Call Weights

| Factor | Weight | |--------|--------| | premiumyield | 20% | | resistancestrength | 20% | | trendalignment | 15% | | upsidebuffer | 15% | | liquidity | 10% | | iscovered | 10% | | timedecay | 5% | | overvaluation | 5% |

Buy Call Weights

| Factor | Weight | |--------|--------| | bullishmomentum | 25% | | breakoutpotential | 20% | | valueefficiency | 20% | | volatilitytiming | 15% | | liquidity | 10% | | time_optimization | 10% |

Buy Put Weights

| Factor | Weight | |--------|--------| | bearishmomentum | 25% | | supportbreak | 20% | | valueefficiency | 20% | | volatilityexpansion | 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 | |-------|-----------------|----------------| | steadyincome | 65-80% | 1-5%/month | | balanced | 40-55% | 50-200% | | highriskhighreward | 20-40% | 2-10x | | hedge | 30-50% | 0-1x |

API Endpoints

Get Option Expirations

GET /api/options/expirations/

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: premiumyield, support/resistancestrength, safetymargin, trendalignment, probabilityprofit, liquidity, timedecay
• ATR safety info (safetyratio, atrmultiples, is_safe)
• Risk-return profile: style, risklevel, winprobability
• 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/.

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/

Returns: ATM IV, IV Rank, HV 30d, VRP, VRP level.

Daily Recommendations (no auth required)

GET /api/options/recommendations?count=5

Typical Workflow

1. Get expirations: GET /api/options/expirations/AAPL
2. Quick IV check: GET /api/options/snapshot/AAPL (free, no quota)
3. Run chain analysis: POST /api/options/chain-sync with symbol + expiry
4. Drill into a specific contract: POST /api/options/enhanced-sync with option_identifier
5. 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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AlphaGBM
• Source: AlphaGBM/skills
• License: MIT
• Homepage: https://www.alphagbm.com/skills

Install and usage instructions live in the source repository linked above.