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

Canonical Options Score

Use this endpoint for the normal "score options" request. It selects an expiry when one is not supplied, applies the requested strategy, and returns ranked recommendations with the trend context and score breakdown.

POST /api/v1/options/score
Authorization: Bearer $ALPHAGBM_API_KEY
Content-Type: application/json

{"ticker": "AAPL", "strategy": "sell_put", "expiry_date": "2026-04-17", "top_n": 5}

strategy accepts sell_put, sell_call, buy_call, buy_put, or all. expiry_date and top_n are optional; top_n is capped at 10. A successful response contains ticker, strategy, current_price, expiry_date, trend, and either recommendations or a strategies object when strategy is all.

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 analysis-credit cost)

GET /api/options/snapshot/<SYMBOL>
Authorization: Bearer $ALPHAGBM_API_KEY

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

Daily Recommendations (no auth required)

GET /api/options/recommendations?count=5

Typical Workflow

1. Score directly: POST /api/v1/options/score with ticker + strategy
2. Quick IV check: GET /api/options/snapshot/AAPL (authenticated, no analysis-credit deduction)
3. Inspect expirations: GET /api/options/expirations/AAPL when the user specifies a date
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

Use the lower-level chain endpoints only when the user asks for raw chain or enhanced analysis. Do not substitute them for the canonical score endpoint.

Quota

• Free account: uses the current account-level daily free allowance; do not assume a per-Skill allowance
• Plus: 1,000/month
• Pro: 5,000/month
• Snapshot does not consume analysis credits but still requires authentication. Recommendations are a public summary endpoint.

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

Offline demo tickers are available without an API key: AAPL, NVDA, SPY, TSLA, META. They use bundled sample data from mock-data/; they are not live API access.

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.