alphagbm-options-score
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".
AlphaGBM · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add AlphaGBM/skills --skill alphagbm-options-score技能说明
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(formatagbm_xxxx...). - Base URL: Default
https://alphagbm.zeabur.app. Override with envALPHAGBM_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
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
- Score directly:
POST /api/v1/options/scorewith ticker + strategy - Quick IV check:
GET /api/options/snapshot/AAPL(authenticated, no analysis-credit deduction) - Inspect expirations:
GET /api/options/expirations/AAPLwhen the user specifies a date - Drill into a specific contract:
POST /api/options/enhanced-syncwith option_identifier - Compare across tickers:
POST /api/options/chain/batchfor multi-symbol analysis
Use the lower-level chain endpoints only when the user asks for raw chain or
阅读完整来源 ↗