gabrielmoreira 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(formatagbm_xxxx…). - Base URL: default
https://alphagbm.zeabur.app. Override with envALPHAGBM_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)
GET /api/stock/quick-quote/<TICKER>
Returns: price, change%, PE, forward PE, 52-week range, sector, market cap.
Example:
curl -H "Authorization: Bearer $ALPHAGBM_API_KEY" \
https://alphagbm.zeabur.app/api/stock/quick-quote/AAPL
2. Full Stock Analysis — Synchronous (blocks 10-30s)
POST /api/stock/analyze-sync
Content-Type: application/json
{"ticker": "AAPL", "style": "balanced"}
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker |
string | yes | Stock ticker (e.g. AAPL, 0700.HK, 600519.SS) |
style |
string | no | quality (default), value, growth, momentum, 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_analysisrisk— score (0-10), level, suggested_position%, risk flagsreport— AI-generated narrative report (markdown, ~2000 chars)
3. Full Stock Analysis — Async (for web frontend)
POST /api/stock/analyze-async
Content-Type: application/json
{"ticker": "TSLA", "style": "growth"}
Returns {"task_id": "uuid"}. Poll task:
GET /api/tasks/<task_id>
4. Stock Search (no auth required)
GET /api/stock/search?q=AAPL&limit=8
Fuzzy search — supports US (AAPL), HK (700, 0700.HK), A-share (600519).
5. Analysis History
GET /api/stock/history?page=1&per_page=10&ticker=AAPL
6. Stock Summary (for options page linkage)
GET /api/stock/summary/<TICKER>
Returns condensed analysis. First-time analysis per ticker is free.
Analysis Model Summary
G = B + M
| Dimension | Components | Weight |
|---|---|---|
| B (Basics) | PE/PEG, growth rate, profit margin, ROE, FCF | Fundamental valuation |
| M (Momentum) | VIX, technical indicators, fund flow, macro | Market sentiment 0-10 |
Risk Score (0-10, additive)
| Factor | Trigger | Points |
|---|---|---|
| Valuation | PE > 60 | +2.0 |
| Growth | Growth < -10% | +2.0 |
| Liquidity | Volume below threshold | +2.0 |
| Market | VIX > 30 | +1.5 |
| Technical | Price < MA200 | +1.0 |
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
EV = (upside_prob x upside_range) + (downside_prob x downside_range)
Weighted = 50% x 1-week + 30% x 1-month + 20% x 3-month
| EV | Recommendation |
|---|---|
| > +8% | STRONG_BUY |
| +3% ~ +8% | BUY |
| -3% ~ +3% | HOLD |
| < -8% | STRONG_AVOID |
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
stop = price - ATR(14) x multiplier(1.5-4.0)
Multiplier adjusts for Beta and VIX. Hard floor: -15%.
Typical Workflow
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:
- Recommendation (STRONG_BUY / BUY / HOLD / AVOID / STRONG_AVOID) + confidence
- Target price vs current price → upside %
- Risk score + level + top risk flags
- Stop-loss price + method
- EV score + weighted EV%
- 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.