# Alphagbm Options Score

> >

- **Type:** Skill
- **Install:** `agentstack add skill-alphagbm-skills-alphagbm-options-score`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AlphaGBM](https://agentstack.voostack.com/s/alphagbm)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AlphaGBM](https://github.com/AlphaGBM)
- **Source:** https://github.com/AlphaGBM/skills/tree/main/skills/alphagbm-options-score
- **Website:** https://www.alphagbm.com/skills

## Install

```sh
agentstack add skill-alphagbm-skills-alphagbm-options-score
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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/
```

### 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/`.

### 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](https://alphagbm.com) -- 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](https://github.com/AlphaGBM)
- **Source:** [AlphaGBM/skills](https://github.com/AlphaGBM/skills)
- **License:** MIT
- **Homepage:** https://www.alphagbm.com/skills

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alphagbm-skills-alphagbm-options-score
- Seller: https://agentstack.voostack.com/s/alphagbm
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.