Returns Polymarket-based sentiment and activity for one stock ticker.

The response combines:

• Period metrics for the date window defined by from/to.
• Representative market-level evidence in top_mentions.
• A compact current market read in pulse.

Fields:

• sentiment_score, bullish_pct, bearish_pct: outcome-aware sentiment derived from Polymarket market prices and outcomes
• buzz_score: normalized activity score for the selected period; both bullish and bearish activity can increase buzz
• trend: recent flow momentum, comparing the current 3 UTC days with the previous 3 UTC days using trades, volume, market breadth and liquidity; this is not stock price movement
• trade_count, market_count, unique_traders, total_liquidity: period activity, breadth, observed participation and liquidity
• daily_trend: daily activity and sentiment values for the selected window
• top_mentions: representative Polymarket markets behind the ticker-level signals, including market-level sentiment_score and buzz_score
• pulse: compact current interpretation from the latest stored open-market snapshots

Notes:

• pulse describes the current state and does not repeat the aggregate fields. Use top_mentions for concrete market examples.
• top_mentions includes only markets observed active/open in the selected period; ranking prioritizes outcome-aware directional evidence, keeps opposing signals visible when present, then uses trade count, market status, volume and liquidity as tie-breakers.
• Prices, volume and liquidity in top_mentions come from the selected in-period snapshot, not necessarily the latest live market state.
• active indicates whether the market is currently open, so older in-period evidence can now be inactive, resolved or expired.
• market_status can be tradable, open, resolved, expired or inactive.
• For windows longer than snapshot retention, aggregate metrics still come from daily aggregates, while top_mentions is limited to retained market snapshots.
• ticker is an Instrument Graph key: a stock's company key (SKHY for SK hynix, BNY), an ETF's product key (EWG). Use /search to find a key by name or listing symbol.
• Returns 200 with found: false when the key is a Graph key but this service has no qualifying data in the requested window. Returns 404 when the key is not a Graph key, including keys used before the Graph switch (for example BK, DAX); there is no fallback or redirect. Returns 503 when the key lookup is unavailable.

{
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "found": true,
  "buzz_score": 68.9,
  "trend": "stable",
  "period_days": 7,
  "trade_count": 312,
  "market_count": 27,
  "current_market_count": 12,
  "unique_traders": 119,
  "sentiment_score": 0.28,
  "bullish_pct": 64,
  "bearish_pct": 36,
  "total_liquidity": 128000,
  "daily_trend": [
    {
      "date": "2026-02-13",
      "trade_count": 5,
      "sentiment_score": 0.25,
      "buzz_score": 64.1,
      "bullish_pct": 64,
      "bearish_pct": 21
    }
  ],
  "top_mentions": [
    {
      "condition_id": "0xabc...",
      "question": "Will AAPL close above $220 this week?",
      "market_type": "close_above",
      "trade_count": 42,
      "sentiment_score": 0.23,
      "buzz_score": 77.2,
      "yes_price": 0.62,
      "no_price": 0.38,
      "liquidity": 7905.52,
      "volume_24h": 2408.43,
      "end_date": "2026-02-28",
      "active": true,
      "market_status": "tradable"
    }
  ],
  "pulse": {
    "mood": "mixed",
    "confidence": 60,
    "thin_data": false,
    "why": [
      "opposing_market_signals",
      "upside_targets_rejected",
      "floor_support"
    ],
    "warnings": [
      "high_average_spread",
      "low_trade_breadth"
    ],
    "evidence": {
      "directional_coverage": 1,
      "traded_market_pct": 0.231,
      "zero_trade_market_pct": 0.769,
      "avg_spread": 0.099,
      "snapshot_at": "2026-06-24T06:25:53Z"
    }
  }
}