{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/audioalpha-io/json-schema/audioalpha-io-asset-snapshot-schema.json",
  "title": "AssetSnapshot",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/audioalpha-io-openapi.json#/components/schemas/AssetSnapshot",
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Asset ticker symbol — crypto tickers are suffixed with \"-USD\" (e.g. BTC-USD)"
    },
    "status": {
      "type": "string",
      "description": "Generation status of the parent daily snapshot. \"completed\" once the snapshot has finished generating (the normal case); \"writing\" while it is being (re)generated, typically during the 00:00–00:01 UTC build window. Always present in the response."
    },
    "version_num": {
      "type": "integer",
      "description": "Revision number of the parent snapshot. Only present when version_info=true."
    },
    "version_label": {
      "type": "string",
      "description": "Version label of the parent snapshot (e.g. \"eod_utc\", \"backfill\"). Only present when version_info=true."
    },
    "alpha_index": {
      "type": "number",
      "description": "Composite narrative strength score (0-1) combining sentiment level, historical deviation, host consensus, and coverage reach"
    },
    "alpha_pulse": {
      "type": "number",
      "description": "Composite narrative momentum score (0-1) measuring how rapidly the podcast narrative is accelerating"
    },
    "episode_count": {
      "type": "integer",
      "description": "Number of episodes mentioning this asset"
    },
    "attention_share": {
      "type": "number",
      "description": "Proportion of mentions this asset received (0-1)"
    },
    "days_since_last_mention": {
      "type": "integer",
      "description": "Days since asset was last mentioned"
    },
    "sentiment_mean": {
      "type": "number",
      "description": "α-sentiment mean for this asset (0-10 scale)"
    },
    "sentiment_median": {
      "type": "number",
      "description": "α-sentiment median for this asset (0-10 scale)"
    },
    "sentiment_std": {
      "type": "number",
      "description": "Standard deviation of α-sentiment scores"
    },
    "sentiment_open": {
      "type": "number",
      "description": "α-sentiment of first podcast of the day (0-10 scale)"
    },
    "sentiment_high": {
      "type": "number",
      "description": "Highest α-sentiment of the day (0-10 scale)"
    },
    "sentiment_low": {
      "type": "number",
      "description": "Lowest α-sentiment of the day (0-10 scale)"
    },
    "sentiment_close": {
      "type": "number",
      "description": "α-sentiment of last podcast of the day  (0-10 scale)"
    },
    "sentiment_delta_1d": {
      "type": "number",
      "description": "Change in α-sentiment vs yesterday (-10 to +10)"
    },
    "sentiment_delta_7d": {
      "type": "number",
      "description": "Change in α-sentiment vs 7 days ago (-10 to +10)"
    },
    "bull_ratio": {
      "type": "number",
      "description": "Proportion of bullish mentions (0-1)"
    },
    "bear_ratio": {
      "type": "number",
      "description": "Proportion of bearish mentions (0-1)"
    },
    "neutral_ratio": {
      "type": "number",
      "description": "Proportion of neutral mentions (0-1)"
    },
    "consensus_score": {
      "type": "number",
      "description": "Agreement among hosts about this asset (0-1)"
    },
    "surprise_score": {
      "type": "number",
      "description": "How surprising the narrative is vs historical (0-1)"
    },
    "novelty_score": {
      "type": "number",
      "description": "How new or surprising the narrative is (0-1)"
    },
    "sentiment_momentum": {
      "type": "number",
      "description": "Trend direction and strength of α-sentiment"
    },
    "narrative_intensity": {
      "type": "number",
      "description": "Intensity of discussion about this asset"
    },
    "narrative_intensity_norm": {
      "type": "number",
      "description": "Normalized narrative intensity (0-1)"
    },
    "summary": {
      "type": "string",
      "description": "Summary of discussions about this asset"
    },
    "spider_chart_url": {
      "type": "string",
      "description": "AudioAlpha spider chart URL, showing daily insight into the asset: α-sentiment, consensus, novelty, attention, and narrative intensity",
      "format": "uri"
    }
  }
}