Compare
Side-by-side factual comparison of 2–200 assets
Returns each asset's full summary plus a cross-asset comparison highlighting divergences in trend, momentum, volume, valuation, and growth.
Credits
1 credit per ticker in the request. A request with tickers=AAPL,MSFT,TSLA costs 3 credits. Compare costs the same per ticker as calling Summary individually, but includes cross-asset divergence analysis at no extra cost.
Tier Limits
Free up to 5 tickers. Plus up to 25 tickers (100 on Commercial). Pro up to 50 tickers (200 on Commercial).
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
tickers | string | — | Required. Comma-separated symbols (e.g. AAPL,MSFT,TSLA) |
timeframe | string | daily | daily or weekly |
date | string | latest | Plus 30 days. Pro full backfill. |
Response Structure
summaries
Object keyed by ticker, each containing a full summary (same structure as the Summary endpoint). Missing tickers return null.
comparison
| Field | Type | Description |
|---|---|---|
performances | object | Each asset's candle performance band |
rsi_zones | object | Each asset's RSI zone side by side |
trend_directions | object | Each asset's trend |
volume_ratio_bands | object | Each asset's volume context |
extremes_conditions | object | Each asset's extreme condition |
range_positions | object | Each asset's range position |
condition_percentiles | object | Each asset's rarity percentile |
valuation_zones | object | Stocks only. Each asset's valuation band |
growth_zones | object | Stocks only. Each asset's growth band |
analyst_consensuses | object | Stocks only. Each asset's analyst consensus |
divergences | array | Factual observations where assets disagree |
Divergence Object
| Field | Type | Description |
|---|---|---|
type | string | e.g. rsi_divergence, trend_divergence, valuation_divergence |
description | string | Human-readable divergence description |
Envelope
| Field | Type | Description |
|---|---|---|
tickers_requested | array | Tickers you sent |
tickers_found | array | Tickers with data |
data_status | string | "eod" |
Example
GET /v1/compare?tickers=NVDA,AMD,INTC
{
"summaries": {
"NVDA": { /* full summary object */ },
"AMD": { /* full summary object */ },
"INTC": { /* full summary object */ }
},
"comparison": {
"performances": {
"NVDA": "moderate_gain",
"AMD": "slight_decline",
"INTC": "sharp_decline"
},
"rsi_zones": {
"NVDA": "neutral_high",
"AMD": "neutral",
"INTC": "deep_oversold"
},
"trend_directions": {
"NVDA": "strong_uptrend",
"AMD": "uptrend",
"INTC": "downtrend"
},
"valuation_zones": {
"NVDA": "overvalued",
"AMD": "fair_value",
"INTC": "deep_value"
},
"divergences": [
{
"type": "trend_divergence",
"description": "NVDA, AMD in uptrend while INTC in downtrend"
},
{
"type": "valuation_divergence",
"description": "INTC is deep_value while NVDA is overvalued"
}
]
},
"tickers_requested": ["NVDA", "AMD", "INTC"],
"tickers_found": ["NVDA", "AMD", "INTC"],
"data_status": "eod"
}