### Typical Workflow Example

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-stock-analysis/SKILL.md

Demonstrates a typical workflow for analyzing a stock, starting with a quick check and proceeding to a full synchronous analysis if the stock is interesting.

```bash
1. Quick check → GET /api/stock/quick-quote/NVDA
2. If interesting → POST /api/stock/analyze-sync {"ticker":"NVDA","style":"growth"}
3. Present: recommendation, target price, risk score, EV, AI report
```

--------------------------------

### Configuration File Example

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Example structure of the AlphaGBM configuration file, showing API key and base URL settings.

```json
{
  "api_key": "agbm_a1b2c3d4e5f6...",
  "base_url": "https://alphagbm.zeabur.app"
}
```

--------------------------------

### Example Workflow: Get Theme News

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Illustrates how to query for news and aggregated data related to a specific theme. This typically involves fetching the theme's details.

```http
GET /api/research/themes/<id>
```

--------------------------------

### Typical Workflow: Get Macro Picture

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-macro-view/SKILL.md

Example of fetching the current macro dashboard for the user.

```bash
2. User: "What's the macro picture?"
   → GET /api/research/macro
   → Present each indicator: value, change, impact on their holdings
```

--------------------------------

### Install AlphaGBM CLI

Source: https://github.com/alphagbm/skills/blob/main/cli/README.md

Install the AlphaGBM CLI tool using pip. Navigate to the 'cli' directory and run the installation command.

```bash
cd cli
pip install -e .
```

--------------------------------

### Install AlphaGBM CLI

Source: https://github.com/alphagbm/skills/blob/main/README.md

Clone the AlphaGBM skills repository and install the command-line interface locally. This allows direct interaction with AlphaGBM's analysis tools from your terminal.

```bash
# Clone and install
git clone https://github.com/AlphaGBM/skills.git
cd skills/cli
pip install -e .

# Set your API key
alphagbm config set-key agbm_xxxxxxxxxxxxxxxx

# Start analyzing
alphagbm stock analyze AAPL
alphagbm options score NVDA
```

--------------------------------

### JSON Output Example

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Example of the JSON output structure for option scoring with detailed recommendation data.

```json
{
  "success": true,
  "ticker": "AAPL",
  "strategy": "sell_put",
  "current_price": 185.50,
  "expiry_date": "2026-04-17",
  "trend": {
    "direction": "uptrend",
    "strength": 0.72,
    "alignment_score": 85
  },
  "recommendations": [
    {
      "rank": 1,
      "strike": 170.0,
      "score": 87.5,
      "premium": 2.35,
      "delta": -0.22,
      "iv": 0.28,
      "atr_safety": "safe",
      "atr_distance_pct": 5.2,
      "style_tag": "conservative_yield",
      "style_label": "🛡️ 保守收入",
      "estimated_win_rate": 0.78,
      "max_loss": 16765.0,
      "return_on_risk": 1.4
    }
  ],
  "meta": {
    "scored_count": 45,
    "filtered_count": 12,
    "scoring_time_ms": 320
  }
}
```

--------------------------------

### Typical Workflow: Add Indicators

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-macro-view/SKILL.md

Example of how to add multiple indicators based on user request.

```bash
1. User: "Track VIX and the 10-year yield"
   → POST /api/research/macro {"indicator_key": "VIX"}
   → POST /api/research/macro {"indicator_key": "US10Y"}
   → Confirm both added with their current values
```

--------------------------------

### Tier Limit Response Example

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-company-profile/SKILL.md

Example of a response when the user's profile creation limit has been reached. Indicates the current number of profiles, the maximum allowed, and suggests an upgrade.

```json
{
  "success": false,
  "error": "Profile limit reached. Upgrade to Plus for 10 profiles.",
  "current": 1,
  "max": 1,
  "upgrade_required": true
}
```

--------------------------------

### List Profiles Response Example

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-company-profile/SKILL.md

Example JSON response when listing company profiles. Includes success status, a list of profiles with basic details, total count, and pagination information.

```json
{
  "success": true,
  "profiles": [{ "ticker": "AAPL", "company_name": "...", "current_price": 261.0, ... }],
  "total": 3,
  "page": 1,
  "per_page": 20
}
```

--------------------------------

### Recommend Options Command

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Get a list of daily option recommendations. Supports specifying the number of recommendations and JSON output.

```bash
alphagbm options recommend
alphagbm options recommend --count 10
alphagbm options recommend --json
```

--------------------------------

### Version Display Output

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Example output when displaying the AlphaGBM CLI version.

```bash
alphagbm --version
# alphagbm, version 0.1.0
```

--------------------------------

### Watchlist API POST Body Examples

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-watchlist/SKILL.md

Examples of the POST request body for adding single or multiple symbols to the watchlist.

```json
{ "symbol": "AAPL" }
```

```json
{ "symbols": ["NVDA", "TSLA", "META"] }
```

--------------------------------

### Typical Workflow: Analyze Impact

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-macro-view/SKILL.md

Example of how to retrieve and use the impact analysis for a specific indicator.

```bash
4. User: "Is high VIX hurting my positions?"
   → GET /api/research/macro → read VIX's impact_analysis field
   → The impact_analysis already references the user's specific holdings
```

--------------------------------

### PE/PB Band Data Response Example

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-company-profile/SKILL.md

Example JSON response for PE/PB band data. Includes ticker, historical PE and PB data points, and current PE/PB percentile rankings.

```json
{
  "success": true,
  "ticker": "AAPL",
  "pe_history": [{"date": "2017-04", "pe": 16.2}, ...],
  "pb_history": [...],
  "current_pe_percentile": 0.82,
  "current_pb_percentile": 0.75
}
```

--------------------------------

### Example Workflow: Create Theme

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Illustrates the sequence of API calls for creating a new theme based on user input. This shows the request payload for theme creation.

```http
POST /api/research/themes
     {"theme_name": "AI Infrastructure", "tickers": ["NVDA","AVGO","MSFT"],
      "news_keywords": ["AI capex", "data center"]}
```

--------------------------------

### Example Workflow: Assess Option IV

Source: https://github.com/alphagbm/skills/blob/main/README.md

This sequence shows how to check if implied volatility (IV) is expensive for a given stock. It involves API calls to get a stock's options snapshot and its volatility surface data.

```bash
7. GET  /api/options/snapshot/AAPL           → IV Rank 58 (moderate)
8. GET  /api/options/tools/vol-surface/AAPL  → ATM IV in contango, earnings in 26d
```

--------------------------------

### Install AlphaGBM Skills for Claude

Source: https://github.com/alphagbm/skills/blob/main/README.md

Clone the AlphaGBM skills repository into the specified directory for Claude. This enables Claude to use AlphaGBM's financial analysis capabilities.

```bash
# Clone into your project
git clone https://github.com/AlphaGBM/skills.git .claude/skills/alphagbm

# Or add as submodule
git submodule add https://github.com/AlphaGBM/skills.git .claude/skills/alphagbm
```

--------------------------------

### Stock Analysis Commands

Source: https://github.com/alphagbm/skills/blob/main/cli/README.md

Perform stock analysis using the CLI. Get a quick quote or a full analysis with specified styles.

```bash
alphagbm stock quote AAPL
```

```bash
alphagbm stock analyze NVDA --style growth
```

--------------------------------

### Snapshot Options Command

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Quickly get IV/VRP snapshot for a stock without consuming quota. Useful for assessing option suitability.

```bash
alphagbm options snapshot AAPL
alphagbm options snapshot TSLA --json
```

--------------------------------

### List All Themes

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Retrieve a list of all created investment themes. This endpoint is useful for getting an overview of existing themes.

```http
GET /api/research/themes
```

--------------------------------

### Create New Theme

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Create a new investment theme with a name, description, initial tickers, and news keywords. This is the starting point for organizing your investment ideas.

```http
POST /api/research/themes
Content-Type: application/json

{
  "theme_name": "AI Infrastructure",
  "description": "Picks & shovels for AI capex",
  "tickers": ["NVDA", "AVGO", "MSFT"],
  "news_keywords": ["AI capex", "data center"]
}
```

--------------------------------

### Scenario 3: AI Agent Integration

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Example of calling the AlphaGBM CLI from within an AI agent (like OpenClaw) and processing the JSON output.

```bash
# 在 OpenClaw skill 中调用
result=$(alphagbm options score AAPL --strategy sell-put --json)
echo "$result" | jq .
```

--------------------------------

### Options Analysis Commands

Source: https://github.com/alphagbm/skills/blob/main/cli/README.md

Score options contracts for specific stocks and strategies. You can also get a snapshot or daily recommendations.

```bash
alphagbm options score AAPL --strategy sell-put
```

```bash
alphagbm options score TSLA --strategy all --expiry 2026-04-17
```

```bash
alphagbm options snapshot AAPL
```

```bash
alphagbm options recommend
```

--------------------------------

### Example Workflow: Analyze Stock and Options

Source: https://github.com/alphagbm/skills/blob/main/README.md

This sequence demonstrates an agent analyzing a stock (AAPL) and identifying an options strategy. It shows API calls for stock quotes, analysis, options snapshots, chain analysis, strategy building, and simulation.

```bash
1. GET  /api/stock/quick-quote/AAPL          → $261.40 (-0.8%)
2. POST /api/stock/analyze-sync              → G=B+M score 7.0/10, EV +5.2%, BUY
   {"ticker": "AAPL", "style": "balanced"}     Risk 4/10, target $275, stop-loss $239

3. GET  /api/options/snapshot/AAPL           → IV 32.5%, IV Rank 58, VRP +4.0%
4. POST /api/options/chain-sync              → Sell Put scores: 80, 78, 75...
   {"symbol": "AAPL", "expiry_date": "..."}    Buy Call scores: 76, 74, 72...

5. POST /api/options/tools/strategy/build    → Bull Call Spread 265/280
   {"template_id": "bull_call_spread"}         Max profit $1085, max loss $415

6. POST /api/options/tools/simulate          → Breakeven $269.15, PoP 44.5%
   {"symbol": "AAPL", "legs": [...]}
```

--------------------------------

### Clone Repository and Setup

Source: https://github.com/alphagbm/skills/blob/main/CONTRIBUTING.md

Clone the AlphaGBM Skills repository and set up the directory for use with AI agents like Claude Code or Cursor. No build step is required.

```bash
git clone https://github.com/AlphaGBM/skills.git
cd skills

# No build step needed -- skills are plain Markdown + JSON
# Just point your AI agent at the skills directory

# For Claude Code
cp -r skills/ /path/to/your/project/.claude/skills/alphagbm/

# For Cursor
cp -r skills/ /path/to/your/project/.cursor/skills/alphagbm/
```

--------------------------------

### Display Help

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

Commands to display help information for the CLI and its subcommands.

```bash
alphagbm --help
alphagbm stock --help
alphagbm options score --help
```

--------------------------------

### Scenario 1: Quick Option Screening

Source: https://github.com/alphagbm/skills/blob/main/cli/docs/CLI_USAGE.md

A three-step process to screen options: check IV environment, score for a strategy, and analyze stock fundamentals.

```bash
# 1. 先看 IV 环境
alphagbm options snapshot AAPL

# 2. VRP > 0 → 适合卖期权，评分
alphagbm options score AAPL --strategy sell-put --top 3

# 3. 详细看股票基本面
alphagbm stock analyze AAPL
```

--------------------------------

### Get Theme Detail

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Retrieve detailed information for a specific theme, including aggregated data like price changes and recent news. Use this to get an in-depth view of a single theme.

```http
GET /api/research/themes/<THEME_ID>
```

--------------------------------

### Example Output Structure for Strategy Recommendation

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-strategy/SKILL.md

This JSON structure details a recommended option strategy, including its rank, score, legs, P&L, breakeven points, and rationale.

```json
{
  "ticker": "AAPL",
  "price": 218.45,
  "market_view": "bullish",
  "iv_environment": "moderate",
  "recommendations": [
    {
      "strategy": "Bull Call Spread",
      "rank": 1,
      "score": 8.5,
      "legs": [
        {"action": "buy", "type": "call", "strike": 215, "expiry": "2026-04-18", "price": 7.20},
        {"action": "sell", "type": "call", "strike": 225, "expiry": "2026-04-18", "price": 3.40}
      ],
      "max_profit": 620,
      "max_loss": 380,
      "breakeven": [218.80],
      "probability_of_profit": 0.58,
      "risk_reward_ratio": 1.63,
      "net_debit": 380,
      "greeks": {
        "delta": 0.32,
        "gamma": 0.012,
        "theta": -0.08,
        "vega": 0.14
      },
      "rationale": "Moderate bullish exposure with capped risk. IV is fair -- debit spread preferred over naked call."
    }
  ]
}
```

--------------------------------

### Duan Analysis API Response Example

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-duan-analysis/SKILL.md

Example JSON response structure for the Duan Analysis API. It includes details for sell put, covered call, and panic buy panels, along with meta-information.

```JSON
{
  "success": true,
  "ticker": "AAPL",
  "stock_price": 185.4,
  "expiry_date": "2026-06-20",
  "dte": 41,
  "sell_put": {
    "strike": 180.0,
    "premium": 2.45,
    "annualized_yield_pct": 12.1,
    "implied_vol": 0.24,
    "delta": -0.28,
    "open_interest": 4821,
    "volume": 312,
    "if_assigned_cost_basis": 177.55,
    "dte": 41
  },
  "covered_call": {
    "strike": 195.0,
    "premium": 2.10,
    "annualized_yield_pct": 10.1,
    "implied_vol": 0.22,
    "delta": 0.32,
    "open_interest": 3200,
    "volume": 198,
    "upside_cap_pct": 5.18,
    "total_return_if_called_pct": 6.31,
    "dte": 41
  },
  "panic_buy": {
    "vix": 18.7,
    "level": "normal",
    "signal": false,
    "action_zh": "VIX 18.7 偏平静。段永平风格下此水位更适合卖 Put 等跌到心理价位，而不是主动抄底。",
    "action_en": "VIX 18.7 is calm. Duan-style strategy prefers Sell-Put \"waiting\" over proactive buying at this level."
  },
  "timestamp": "2026-04-24T08:00:00"
}
```

--------------------------------

### Typical Workflow for Investment Theses

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-investment-thesis/SKILL.md

Illustrates the step-by-step interaction for creating, querying, and updating investment theses via API calls.

```text
1. User: "I'm buying NVDA because AI capex is still accelerating"
   → (ensure profile exists — see alphagbm-company-profile)
   → POST /api/research/theses with buy_thesis + sell_conditions
   → Confirm: "Saved. Monitoring: price drop > 20%, PE > 60, growth < 15%."

2. User: "What are my active theses?"
   → GET /api/research/theses?status=active
   → Table: ticker · one-line thesis · conditions · score

3. User: "Any theses triggered?"
   → GET /api/research/theses?status=triggered
   → Alert list with trigger_detail explaining why

4. User: "Update my NVDA thesis — exit if PE > 70 instead of 60"
   → GET /api/research/theses/NVDA to find id
   → PUT /api/research/theses/<id> with revised sell_conditions
```

--------------------------------

### Get Triggered Alerts

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-alert/SKILL.md

Retrieves a list of recently triggered alerts with their associated context.

```APIDOC
## Get Triggered Alerts

### Description
Retrieves a list of recently triggered alerts, providing full context for each.

### Method
GET

### Endpoint
`/api/user/alerts/triggered`

### Response Fields
- **alert_id** (string) - The unique identifier for the triggered alert.
- **status** (string) - The status of the alert when triggered.
- **condition_summary** (string) - A summary of the alert's conditions.
- **triggered_alerts** (array) - Details of the specific trigger event.
- **context** (object) - Additional contextual information related to the alert trigger.
```

--------------------------------

### Install AlphaGBM Skills for Cursor

Source: https://github.com/alphagbm/skills/blob/main/README.md

Clone the AlphaGBM skills repository into the specified directory for Cursor. This allows Cursor to access AlphaGBM's financial data and analysis tools.

```bash
git clone https://github.com/AlphaGBM/skills.git .cursor/skills/alphagbm
```

--------------------------------

### Typical Workflow: Remove Indicator

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-macro-view/SKILL.md

Example of removing a specific indicator based on user request.

```bash
3. User: "Stop tracking DXY"
   → DELETE /api/research/macro/DXY
```

--------------------------------

### Get Watchlist Alerts

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-watchlist/SKILL.md

Retrieves only the active alerts for tickers currently in the user's watchlist.

```APIDOC
## GET /api/user/watchlist/alerts

### Description
Fetches a list of all active alerts associated with the tickers in the user's watchlist.

### Method
GET

### Endpoint
/api/user/watchlist/alerts

### Response
#### Success Response (200)
- **alerts** (array) - A list of active alerts, each detailing the ticker and the nature of the alert.

#### Response Example
{
  "alerts": [
    {
      "symbol": "NVDA",
      "alert_type": "iv_rank_change",
      "message": "NVDA IV Rank increased to 85."
    },
    {
      "symbol": "TSLA",
      "alert_type": "unusual_activity",
      "message": "Unusual options flow detected for TSLA."
    }
  ]
}
```

--------------------------------

### Configuration Commands

Source: https://github.com/alphagbm/skills/blob/main/cli/README.md

Manage AlphaGBM CLI configuration. Set API keys, base URLs, or view the current configuration.

```bash
alphagbm config set-key KEY
```

```bash
alphagbm config set-url URL
```

```bash
alphagbm config show
```

--------------------------------

### Get Option Expirations

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-score/SKILL.md

Retrieves available option expiration dates for a given stock symbol.

```APIDOC
## Get Option Expirations

### Description
Retrieves available option expiration dates for a given stock symbol.

### Method
GET

### Endpoint
/api/options/expirations/<SYMBOL>
```

--------------------------------

### Get Hot Options List

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-watchlist/SKILL.md

Retrieves a curated list of tickers identified as having the most interesting options activity.

```APIDOC
## GET /api/analytics/hot-options

### Description
Provides a list of tickers that are currently exhibiting significant or noteworthy options trading activity.

### Method
GET

### Endpoint
/api/analytics/hot-options

### Response
#### Success Response (200)
- **hot_options** (array) - A list of tickers identified as 'hot options'.

#### Response Example
{
  "hot_options": [
    {
      "symbol": "AMD",
      "reason": "High volume call options"
    },
    {
      "symbol": "GOOG",
      "reason": "Unusual put activity"
    }
  ]
}
```

--------------------------------

### Get Option Expirations API Endpoint

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-score/SKILL.md

Retrieve available option expiration dates for a given stock symbol.

```bash
GET /api/options/expirations/<SYMBOL>
```

--------------------------------

### Example User Queries for IV Rank Skill

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-iv-rank/SKILL.md

Demonstrates natural language queries to retrieve IV Rank, percentile, historical data, and trading recommendations. These queries cover various aspects of volatility analysis.

```text
"IV rank AAPL"
```

```text
"Is NVDA IV high?"
```

```text
"IV percentile SPY"
```

```text
"Historical IV TSLA"
```

```text
"Is volatility cheap for META?"
```

```text
"Should I sell premium on QQQ?"
```

--------------------------------

### Get Options Snapshot

Source: https://github.com/alphagbm/skills/blob/main/README.md

Retrieves a snapshot of options data for a given symbol, including implied volatility and IV rank.

```APIDOC
## GET /api/options/snapshot/[symbol]

### Description
Fetches a snapshot of key options metrics for a given stock symbol, including implied volatility (IV) and IV Rank.

### Method
GET

### Endpoint
/api/options/snapshot/{symbol}

### Parameters
#### Path Parameters
- **symbol** (string) - Required - The stock symbol (e.g., AAPL).

### Response
#### Success Response (200)
- **IV** (string) - The current Implied Volatility (e.g., "32.5%").
- **IV Rank** (string) - The Implied Volatility Rank (e.g., "58").
- **VRP** (string) - The Volatility Risk Premium (e.g., "+4.0%").
```

--------------------------------

### Example Workflow: Add Ticker to Theme

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-theme-research/SKILL.md

Shows the process of adding a new ticker to an existing theme. This involves finding the theme's ID and then performing a partial update.

```http
PUT /api/research/themes/<id> {"tickers": [... + "ORCL"]}
```

--------------------------------

### API Endpoint for Marks Cycle

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-marks-cycle/SKILL.md

This is the GET endpoint to retrieve the market cycle score and posture. No body or authentication is required.

```http
GET /api/masters/marks-cycle
```

--------------------------------

### Build a Strategy from a Template

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-strategy/SKILL.md

Construct a specific option strategy by providing a template ID and parameters like spot price, expiry, and strike prices.

```http
POST /api/options/tools/strategy/build
Content-Type: application/json

{
  "mode": "template",
  "template_id": "bull_call_spread",
  "spot": 150.0,
  "expiry_days": 30,
  "strikes": [140, 145, 150, 155, 160]
}
```

--------------------------------

### Get Thesis by Ticker

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-investment-thesis/SKILL.md

Retrieve the active investment thesis for a specific company ticker. Returns 404 if no active thesis exists.

```bash
GET /api/research/theses/<TICKER>
```

--------------------------------

### GET Request for Latest Health Report

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-health-check/SKILL.md

Retrieve the most recent automated health report for the knowledge base. This endpoint is available to all users.

```http
GET /api/research/health
```

--------------------------------

### Get Specific Event Polymarket Data

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-polymarket/SKILL.md

Retrieves detailed Polymarket and options-implied probability data for a specific event, identified by its event ID.

```APIDOC
## GET /api/analytics/polymarket/event/{event_id}

### Description
Retrieves detailed Polymarket and options-implied probability data for a specific event, identified by its event ID. This endpoint provides a focused view on a single event's market pricing.

### Method
GET

### Endpoint
/api/analytics/polymarket/event/{event_id}

### Parameters
#### Path Parameters
- **event_id** (string) - Required - The unique identifier for the event.

#### Query Parameters
- **include_trades** (bool) - Optional - Whether to include suggested options trades in the response. Defaults to true.

### Response
#### Success Response (200)
- **polymarket_prob** (float) - The probability of the event according to Polymarket.
- **options_implied_prob** (float) - The probability of the event implied by options prices.
- **spread** (float) - The difference between Polymarket and options-implied probabilities.
- **confidence** (float) - A confidence score for the mispricing signal.
- **suggested_trades** (array) - A list of suggested options trades to exploit the mispricing.
- **historical_accuracy** (float) - The historical accuracy of similar predictions.
```

--------------------------------

### List Available Strategy Templates

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-strategy/SKILL.md

Use this endpoint to retrieve a list of all supported option strategy templates.

```http
GET /api/options/tools/strategy/templates
```

--------------------------------

### Workflow Example: User Requesting Health Check

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-health-check/SKILL.md

Illustrates a typical user interaction flow for requesting and receiving a knowledge base health check, including fallback for non-Pro users.

```text
1. User: "How's my research brain looking?"
   → GET /api/research/health
   → If has_report=false: "No report yet — your first auto-audit runs on <day>. 
      Pro users can trigger one now."
   → If has_report=true: present score + top 3 recommendations

2. User (Pro): "Run a fresh health check now"
   → POST /api/research/health/generate
   → Present the new report

3. User (Free/Plus): "Run a health check"
   → POST /api/research/health/generate returns 403
   → Fall back: show the last weekly auto-report via GET, suggest upgrade

4. User: "Fix the stale ones"
   → For each recommendation with action=refresh:
     POST /api/research/profiles/<ticker>/refresh
   → Re-check: GET /api/research/health → show updated score
```

--------------------------------

### Health Report Not Found Response

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-health-check/SKILL.md

Example JSON response when no health report has been generated yet. Indicates that the first automated audit has not yet run.

```json
{
  "success": true,
  "has_report": false
}
```

--------------------------------

### Build Strategy from Template

Source: https://github.com/alphagbm/skills/blob/main/skills/alphagbm-options-strategy/SKILL.md

Constructs a specific option strategy based on a chosen template and provided parameters such as spot price, expiry, and strike prices. This endpoint allows for detailed customization of a strategy.

```APIDOC
## POST /api/options/tools/strategy/build

### Description
Builds a strategy from a template with specific parameters.

### Method
POST

### Endpoint
/api/options/tools/strategy/build

### Request Body
- **mode** (string) - Required - Specifies the build mode, expected to be "template".
- **template_id** (string) - Required - The ID of the strategy template to use (e.g., "bull_call_spread").
- **spot** (number) - Required - The current spot price of the underlying asset.
- **expiry_days** (integer) - Required - The number of days until the option expires.
- **strikes** (array of numbers) - Required - A list of strike prices to consider for the strategy.

### Request Example
{
  "mode": "template",
  "template_id": "bull_call_spread",
  "spot": 150.0,
  "expiry_days": 30,
  "strikes": [140, 145, 150, 155, 160]
}
```