What is AlphaGBM?

AlphaGBM is a real-data market intelligence layer for traders and AI agents. It connects live market data, quantitative scoring, research workflows and ongoing verification to the tools people already use.

These 29 skills bring AlphaGBM's capabilities into Claude Code, Cursor, Windsurf, Codex, WorkBuddy or any agent that supports skills.

Why AlphaGBM?

Capability	What the Skills provide
Data access	Call AlphaGBM APIs from your AI workspace; distinguish live responses from bundled demos
Options intelligence	Scoring, volatility, Greeks and strategy workflows with endpoint-specific contracts
Stock research	Fundamental, sentiment and risk analysis; risk scores are not return probabilities
Published research	Read public abstracts and preserve source links, publication times and evidence when provided; full research access may be tier-gated
Shared account	Authenticated calls use the account behind your API key, not a separate Skills allowance
Investor frameworks	Optional research lenses, distinct from validated scoring models

Market coverage, data freshness and API-key access vary by endpoint. Private Research Brain and newer multi-asset workflows remain under contract review; their presence in the product is not a blanket API-access guarantee.

Quick Start

Install as Claude Code Skills

# 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

Install for Cursor

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

Install CLI

# 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

See cli/README.md for full CLI documentation.

Try It (No API Key Needed)

Selected market tools include bundled samples for AAPL, NVDA, SPY, TSLA and META. Explicitly request demo mode to use them; never present a stored sample as a current quote. Research Insights uses published articles, not bundled samples.

"Analyze AAPL stock using AlphaGBM" "Score NVDA options" "Show me TSLA's volatility surface" "What's the best bullish strategy for META?"

Connect Live Data

# Set your API key for real-time data
export ALPHAGBM_API_KEY=agbm_xxxxxxxxxxxxxxxx
export ALPHAGBM_BASE_URL=https://alphagbm.zeabur.app  # optional, this is the default

# Get your free key at https://alphagbm.com/api-keys

Check API Health

curl https://alphagbm.zeabur.app/api/health

Returns API status, available data fields, data source health, and market coverage — no auth needed. Useful for AI agents to verify what's available before making calls.

Quota

Authenticated calls use the account associated with your API key; installing a Skill does not create a separate allowance. Access, quota and cache behavior depend on the endpoint and deployed environment. Consult your account for current limits rather than assuming a cached call is free. The current public Research Insights reader exposes published summaries; the product may gate full reports, deeper interpretation and ongoing verification behind account access.

Skills Overview

Opportunity & Research (8 skills)

Skill	What It Does	Example Query
Stock Analysis	G=B+M model: fundamentals, momentum, EV, risk score, AI report	"Analyze AAPL"
Options Score	Score 0-100 across 4 strategies (Sell Put/Call, Buy Put/Call)	"Best NVDA call to buy"
Options Strategy	Strategy builder + scanner with 15+ templates	"Bullish play on TSLA"
Vol Surface	3D implied volatility across strikes & expiries	"Is AAPL IV expensive?"
Vol Smile	Skew analysis for a single expiration	"NVDA put skew"
Greeks	Greeks calculator + implied volatility solver	"Greeks for AAPL 220C"
P&L Simulator	What-if analysis for any position	"Simulate my iron condor"
Chokepoint Analysis	Map supply-chain bottlenecks and test concentration, irreplaceability and demand tension	"Find AI supply-chain chokepoints"

Data Intelligence (6 skills)

Skill	What It Does	Example Query
IV Rank	IV percentile vs. 252-day history	"Is TSLA IV high?"
Earnings IV Panel	Crush history + implied move + IV Rank tag + priced Iron Condor	"Iron Condor for META earnings"
Unusual Activity	Smart money / large block detection	"Unusual options flow today"
Market Sentiment	VIX, Put/Call, Fear & Greed dashboard	"Market sentiment now"
VIX Status ✨	5-tier fear thermometer: calm / normal / seller sweet spot / caution / extreme fear	"Is this a good time for BPS?"
FearScore ✨	Per-ticker 6-indicator panic composite; ≥60 is BPS entry signal	"Fear score QQQ", "is NVDA oversold"

Workflow Tools (4 skills)

Skill	What It Does	Example Query
Compare	Side-by-side stock & options comparison	"AAPL vs MSFT"
Watchlist	Monitor tickers for key changes	"Add NVDA to watchlist"
Alert	Set IV, price, or activity alerts	"Alert if TSLA IV > 80"
Polymarket	Prediction market vs. options pricing	"Rate cut odds vs options"

Risk & Portfolio Discipline (3 skills) ✨

Exit, hedge, and sizing decisions quantified from real data — not opinion.

Skill	What It Does	Example Query
Hedge Advisor ✨	Scenario-driven hedge for an existing position (Falling Knife / Bottom Fishing / Gain Protection); returns priced Long Put / Collar / Tier-down specs	"Hedge my AAPL at cost 140, now 180"
BPS Backtest ✨	Walk-forward backtest of Bull Put Spread with signal vs no-signal control in one call	"Backtest BPS on QQQ — does FearScore work?"
Take-Profit Lab ✨	Any-ticker 15-strategy exit backtest; auto-classifies whether it's holdable or needs tiered exit via a novel "rollercoaster rate" metric	"Should I hold TQQQ long-term?"

Investor Masters (4 skills) 🎓

Mechanical translations of specific investors' philosophies into one-call tools.

Skill	What It Does	Example Query
Duan-Yongping Analysis	Three-panel seller playbook (Sell Put at willing-buy price / Covered Call yield / VIX-tier panic-buy context)	"Duan-style analysis on AAPL"
Buffett Analysis ✨	4-lens scorecard (business / moat / management / valuation) → weighted HOLDABLE / WATCHABLE / AVOID verdict for any ticker	"Buffett analysis on KO"
Marks Cycle ✨	Howard Marks-style cycle position 0-100 blending VIX + IV Rank + P/C + valuation; maps to offense/defense posture. Authenticated signal, no analysis-credit deduction	"Where are we in the cycle?"
Tepper Signal ✨	Quantified Tepper 2009/2020 panic-buy detector: VIX ≥ 35 + FearScore ≥ 80 + quality filter → armed/watch/near/cold	"Is this a Tepper buy signal?"

Research & Knowledge (6 skills)

Build a personal, monitored research workspace. Profiles auto-refresh, theses get checked against triggers, the system audits itself weekly.

Skill	What It Does	Example Query
Company Profile	Auto-built research files: fundamentals, PE/PB band, red flags, event radar	"Add NVDA to my knowledge base"
Investment Thesis	Buy reasons + structured sell triggers, monitored automatically	"Why did I buy AAPL?"
Macro View	Track VIX / US10Y / DXY / gold with portfolio-aware impact analysis	"Track VIX and US10Y"
Theme Research	Group tickers into themes (AI infra, HK dividend) + news keyword watching	"Create an AI infra theme"
Health Check	Weekly audit: stale profiles, thesis drift, orphan pages → 0-100 score	"Audit my research brain"
Research Insights	Retrieve published AlphaGBM research with market, tag, date and source metadata	"Show the latest semiconductor research"

See Also

• Investment Masters -- 12 masters' methodologies (Buffett, Dalio, Soros, Marks, Liang Wenfeng, Raschke...) + 13F tracking

Architecture

You / Your AI Agent
    |  (natural language)
+------------------------------------------------------+
|              AlphaGBM Skills (this repo)              |
|                                                       |
|  Stock    Options   Vol      Strategy   Greeks   ...  |
|  Analysis  Score   Surface   Builder    Dashboard     |
+-------------------------+-----------------------------+
                          |
               +----------+----------+
               v                     v
         Mock Data              AlphaGBM API
      (built-in, free)      (alphagbm.zeabur.app)
                             Real-time market data
                             IV/HV/VRP/Greeks/Skew

How Skills Connect

Skills aren't isolated -- they reference each other to form a complete workflow:

Stock Analysis --> Options Score --> Options Strategy --> P&L Simulator
       |                |                    |
       v                v                    v
   Compare          Vol Surface           Greeks
                    Vol Smile
                    IV Rank --> Earnings Crush

Market Sentiment --> Unusual Activity --> Alert
                                          Watchlist

Polymarket --> Market Sentiment --> Options Strategy

Data Coverage

Market	Stocks	Options	Data Points
US	200+	Full chains	IV/HV/VRP/Greeks/Skew/Surface
HK	35+	Full chains	IV/HV/VRP/Greeks
CN	20+ ETFs	Full chains	IV/HV/VRP/Greeks
Commodities	Au/Ag/Cu/Al	Futures options	IV/Greeks/Delivery risk

Real Data, Not Guesswork

Illustrative metrics below are not current quotes. Preserve actual source, timestamp and missing-data fields when interpreting API responses:

Metric	Value	How It's Computed
IV	32.5%	Black-Scholes on actual bid/ask prices
IV Rank	58	Current IV vs. 252 trading days of history
VRP	+4.0%	Implied Vol - Historical Vol — measures option overpricing
Option Score	80/100	Weighted: premium yield + support/resistance + safety margin + trend + PoP + liquidity + time decay
Stock Risk	API value	risk.score describes risk, not an opportunity score or probability of profit
Risk	4/10	Additive: valuation +2, growth +2, liquidity +2, market +1.5, technical +1
EV	+5.2%	50% × 1w + 30% × 1m + 20% × 3m expected value

This is not "based on my training data" or "I estimate with 85% confidence."

This is math on market data.

Example Workflow

You: "Analyze AAPL, then find the best options play"

The agent chains skills automatically:

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": [...]}

You: "Is that IV expensive?"

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

All from real API calls. All verifiable.

Roadmap

• 29 Skill definitions; selected market tools include demo data
• Claude Code & Cursor support
• CLI tool (pip install -e ./cli)
• Real-time WebSocket feeds
• Community strategy sharing
• More markets (EU, JP, KR options)

Contributing

See CONTRIBUTING.md for guidelines. We welcome:

• Bug reports & feature requests
• Skill improvements & new skill proposals
• Translations (currently EN + CN)
• Mock data for additional tickers

License

MIT -- see LICENSE.

Links

• alphagbm.com -- Full platform with live data
• API Documentation
• Discord Community
• Twitter/X

---