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

Sell Call Weights

Buy Call Weights

Buy Put Weights

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

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

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

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.