Response schema

All snapshot responses include:

• schemaVersion (currently 2025-01-01)

• generatedAt (ISO timestamp)

Global snapshot (/snapshot/global)

Top-level shape (full format):

• windowStart, windowEnd: the time window summarized

• cryptoPulse, tradfiPulse: the core pulse payloads

• macroClusters: array of macro narrative clusters (when available)

• correlationLayer: relationship between BTC and SPY (tracking/mixed/decoupled)

• cryptoBasket: top 10 crypto assets by market cap with aggregated metrics

• marketMovement: directional labels + confidence for crypto and TradFi

• dataQuality: partial stream flags + confidence

• sourceBreakdown: weights and counts (useful for observability)

Domain pulses (/snapshot/crypto, /snapshot/tradfi)

Shape:

• pulse: the core pulse payload for that domain

• marketMovement: movement signal for that domain (when available)

• dataQuality

Asset view (/snapshot/asset/:symbol)

Shape:

• symbol: normalized ticker

• narratives: narrative cards relevant to the symbol

• correlationLayer

• marketMovement (when available)

• generatedAt

Pulse fields (high level)

Common pulse fields:

• domain: "crypto" or "tradfi"

• sentiment: "bullish" or "bearish"

• moodIndex: 0 - 100

• trendingTickers: array of current tickers in focus

• wsbHeat: 0 - 100 scale (TradFi only, when applicable)

• insights: structured insights object containing:

  • quickTake: synopsis + topSignals array

  • focusAreas: array of narrative cards with headline, stance, setup, implication, watchPoints, linkedNarrativeIds

  • outlook: forward-looking summary

Crypto-specific additions:

• fearGreedIndex: 0 - 100 scale

• fearGreedLabel: "Fear", "Greed", etc.

Correlation layer

• status: "tracking", "mixed", or "decoupled"

• correlationIndex: 0–100 numeric correlation score

• anchorsUsed: price anchor data:

  • cryptoAnchorChange24hPct: BTC 24h % change

  • tradfiAnchorChange24hPct: SPY/QQQ 24h % change

• analysis: text description of correlation

• confidence: "high", "medium", or "low"

• notes: additional context

Crypto basket

Top 10 crypto assets by market cap with aggregated metrics:

• method: calculation method (e.g., "cap_weight")

• asOf: timestamp of basket calculation

• change24hPct: aggregate 24h % change

• change7dPct: aggregate 7d % change

• breadth: market breadth metrics:

  • advancers: count of assets up 24h

  • decliners: count of assets down 24h

• dispersion24hPct: dispersion metric

• coverage: basket coverage:

  • includedCount: number of assets included

  • totalCount: total assets considered

  • marketCapCoveragePct: % of market cap covered

• constituents: an array of asset objects with:

  • symbol, name

  • change24hPct, change7dPct

  • marketCapUsd, volume24hUsd (when available)

  • weight: basket weight (0–1)

  • isMissing: boolean indicating if price data is missing

Market movement

Directional signals for crypto and TradFi:

• crypto.label: "up", "down", or "neutral"

• crypto.reason: text explanation

• crypto.confidence: 0–1 confidence score

• tradfi.label: "up", "down", or "neutral"

• tradfi.reason: text explanation

• tradfi.confidence: 0–1 confidence score

Data quality

• partialStreams: an array of stream identifiers that are partially available (e.g., "price:token:BTC")

• confidence: "high", "medium", or "low"

Source breakdown

• weights: source weight configuration:

  • crypto: weights for xKolStream, redditStream, macroNewsStream

  • tradfi: weights for xKolStream, redditStream, macroNewsStream, wsbMaxContributionCap

• counts: actual usage counts:

  • xPostsUsed: number of X posts used

  • redditPostsUsed: number of Reddit posts used

  • redditCommentsUsed: number of Reddit comments used

  • macroItemsUsed: number of macro news items used

Compact trading format

Request with format=compact_trading (optionally add fields=... to project down).

Example:

{
  "ts": 1703424000,
  "mood": 62,
  "sentiment": "bullish",
  "corr_status": "tracking",
  "corr_conf": 0.78,
  "signals": ["BTC", "ETH"],
  "rec": "execute_with_caution",
  "cost_usdc": 0.02
}