LeaderboardHighlights

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/audioalpha-io/json-schema/audioalpha-io-leaderboard-highlights-schema.json",
  "title": "LeaderboardHighlights",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/audioalpha-io-openapi.json#/components/schemas/LeaderboardHighlights",
  "type": "object",
  "properties": {
    "top_alpha_index": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with highest surprise score"
    },
    "top_alpha_pulse": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with highest surprise score"
    },
    "top_riser": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with highest positive sentiment change"
    },
    "top_dropper": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with largest negative sentiment change"
    },
    "most_mentioned": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with highest attention share"
    },
    "most_surprising": {
      "allOf": [
        {
          "$ref": "#/$defs/LeaderboardEntry"
        }
      ],
      "description": "Asset with highest surprise score"
    }
  },
  "$defs": {
    "LeaderboardEntry": {
      "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"
        },
        "category": {
          "type": "string",
          "description": "Leaderboard category (top_alpha_index, top_alpha_pulse, top_riser, top_dropper, most_mentioned, most_surprising)"
        },
        "value": {
          "type": "number",
          "description": "Primary metric value for this category"
        }
      }
    }
  }
}