Alphagbm Stock Analysis

AlphaGBM Stock Analysis

Analyze stocks via the AlphaGBM API — a G = B + M (Gain = Basics + Momentum) model combining fundamental analysis, market sentiment, EV expectation, ATR stop-loss, sector rotation, and AI reports.

The current API exposes a 0-10 risk score, not a standalone 1-10 stock opportunity score. Do not present risk.score as a probability of return or as an automatic buy recommendation.

When to use

• User asks to analyze a stock ticker (US / HK / A-share)
• User asks for a stock quote, target price, risk score, or EV recommendation
• User mentions AlphaGBM or wants a comprehensive stock analysis

Prerequisites

• Account authentication: store an API key in env ALPHAGBM_API_KEY (format agbm_xxxx…).
• Base URL: default https://alphagbm.zeabur.app. Override with env ALPHAGBM_BASE_URL.
• If the user has neither, tell them to register at https://alphagbm.com and create a key at /api-keys.

API Endpoints

All endpoints require Authorization: Bearer $ALPHAGBM_API_KEY.

1. Quick Quote (instant, no quota cost)

Copy code
GET /api/stock/quick-quote/<TICKER>

Returns: price, change%, PE, forward PE, 52-week range, sector, market cap.

Example:

bashCopy code
curl -H "Authorization: Bearer $ALPHAGBM_API_KEY" \
  https://alphagbm.zeabur.app/api/stock/quick-quote/AAPL

2. Full Stock Analysis — Synchronous (blocks 10-30s)

Copy code
POST /api/stock/analyze-sync
Content-Type: application/json

{"ticker": "AAPL", "style": "balanced"}

Add ?compact=true for a condensed agent-friendly response (~500 tokens).

Response contains:

• data — price, PE, PEG, growth, margin, target_price, stop_loss_price, market_sentiment (0-10), ev_model, sector_analysis, capital_analysis
• risk — score (0-10), level, suggested_position%, risk flags
• report — AI-generated narrative report (markdown, ~2000 chars)

3. Full Stock Analysis — Async (for web frontend)

Copy code
POST /api/stock/analyze-async
Content-Type: application/json

{"ticker": "TSLA", "style": "growth"}

Returns {"task_id": "uuid"}. Poll task:

Copy code
GET /api/tasks/<task_id>

4. Stock Search (no auth required)

Copy code
GET /api/stock/search?q=AAPL&limit=8

Fuzzy search — supports US (AAPL), HK (700, 0700.HK), A-share (600519).

5. Analysis History

Copy code
GET /api/stock/history?page=1&per_page=10&ticker=AAPL

6. Stock Summary (for options page linkage)

Copy code
GET /api/stock/summary/<TICKER>

Returns condensed analysis. First-time analysis per ticker is free.

Analysis Model Summary

G = B + M

Risk Score (0-10, additive)

Risk >= 6 → very high risk / generally avoid · 4-<6 → high risk · 2-<4 → medium risk · < 2 → lower risk. Position sizing remains subject to the returned analysis and the user's own risk policy.

EV Expectation Model

Copy code
EV = (upside_prob x upside_range) + (downside_prob x downside_range)
Weighted = 50% x 1-week + 30% x 1-month + 20% x 3-month

Target Price — 5 methods, industry-weighted

PE valuation · PEG valuation · Growth discount · DCF · Technical analysis. Risk adjustment: high risk → -15%, medium risk → -8%.

ATR Stop-Loss

Copy code
stop = price - ATR(14) x multiplier(1.5-4.0)

Multiplier adjusts for Beta and VIX. Hard floor: -15%.

Typical Workflow

Copy code
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

Quota

• Live analysis requires authentication and is subject to the account's current free allowance or subscription credits. Do not hardcode plan limits here.
• Quick quote does not consume analysis credits, but live access still follows the endpoint's authentication policy.

Output Formatting Tips

When presenting results to the user, highlight:

1. Recommendation (STRONG_BUY / BUY / HOLD / AVOID / STRONG_AVOID) + confidence
2. Target price vs current price → upside %
3. Risk score + level + top risk flags
4. Stop-loss price + method
5. EV score + weighted EV%
6. Key excerpt from AI report (first 2-3 paragraphs)

Mock Data

When no API key is configured, this skill uses built-in market data snapshots from mock-data/. Supported offline demo tickers: AAPL, NVDA, SPY, TSLA, META. This is not live API access.

Related Skills

• alphagbm-options-score — After stock analysis, evaluate options opportunities
• alphagbm-compare — Compare multiple stocks side-by-side
• alphagbm-market-sentiment — Broader market context for the analysis

Powered by AlphaGBM — Real-data options & research intelligence for traders and AI agents. 10K+ users.