One REST API for every analysis we publish.

# 1. Get an API key from /preferences → API
export SMA_KEY="sa_4f8a...redacted"

# 2. Pull the latest MSFT analysis pack
curl https://api.stockmarketagent.ai/api/v1/stocks/MSFT/analysis-pack \
  -H "X-API-Key: $SMA_KEY"

The analysis-pack endpoint returns one top-level JSON document with meta, computed model output, sensitivity data, scoring, and peer context. Collection endpoints use Laravel's data envelopes. Numeric fields use unsuffixed base units — USD for prices, decimals (0–1) for probabilities, integers for confidence scores.

What's in an analysis pack

The headline action plus a 0–100 confidence score, the low/mid/high fair-value range, and bull/base/bear scenarios with probabilities that sum to 1.0 when those models are available. For the full report envelope and all 14 reader sections, use /stocks/{ticker}/reports/latest?include=sections.

What's not

We don't bill the public website HTML as API content, and the analysis pack is not a rendered report. Use the report endpoint when you need the canonical prose sections and report metadata.

{
  "meta": {
    "ticker": "MSFT",
    "name": "Microsoft Corporation",
    "sector": "Technology",
    "generated_at": "2026-04-25T12:00:00Z"
  },
  "archetype": {
    "archetype": "mature_compounder",
    "archetype_label": "Mature compounder"
  },
  "score": {
    "rating_band": "Strong Buy",
    "confidence_score": 87,
    "six_factor_score": 82
  },
  "valuation_results": {
    "synthesis": {
      "fair_value_low": 480,
      "fair_value_mid": 545,
      "fair_value_high": 612,
      "currency": "USD"
    }
  },
  "sensitivity_results": {
    "ke_vs_terminal_growth": "5x5 matrix omitted for brevity"
  }
}