Stock Analysis
Professional equity analysis and comparisons
What It Does
The Stock Analysis API delivers institutional-grade equity analysis. Send one symbol for a deep-dive analysis, or two symbols for a detailed comparison. Each report includes financial metrics, growth drivers, and actionable insights.
Single Stock Analysis
- • Financial health assessment
- • Growth drivers & catalysts
- • Risk factors & challenges
- • Investment thesis
- • Key metrics with context
Stock Comparison
- • Head-to-head metrics
- • Competitive positioning
- • Relative valuation
- • Growth trajectories
- • Investment trade-offs
When to Use
Perfect For
- • Investment committee presentations
- • Client portfolio reviews
- • Buy/sell decisions
- • Sector comparisons
- • Due diligence reports
Not Ideal For
- • Real-time price data
- • Technical analysis
- • Options strategies
- • Intraday trading
- • Raw financial statements
Examples
Single Stock Analysis
Request
POST /api/products/stock-report
{
"symbols": ["MSFT"]
}Response Structure
{
"detailed_analysis": [
{
"title": "Cloud Dominance",
"keyMetric": "$24.1B revenue (+29%)",
"implications": [...],
"category": "growth"
}
],
"quick_insights": [...]
}Stock Comparison
Request
POST /api/products/stock-report
{
"symbols": ["AAPL", "MSFT"]
}Response Focus
Response Structure
Detailed Analysis
title
Key insight headline
keyMetric
Supporting data point with context
implications
Array of investment implications
investmentThesis
One-line investment summary
category
growth | profitability | risk | valuation | competitive
Quick Insights
Array of 2-4 actionable, single-sentence insights perfect for executive summaries.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbols | string[] | Yes | 1 symbol for analysis, 2 for comparison |
| language | string | No | ISO 639-1 code (default: "en") |
| data | object | No | Additional financial data or context |
Pro Tips
Compare competitors: Use 2 symbols from the same sector for meaningful comparisons.
Add context: Include recent earnings or metrics in the `data` field for richer analysis.
Processing time: Single stocks: ~10-20s, Comparisons: ~30-45s. Plan accordingly.
Client reports: The structured format integrates perfectly into automated reports.