v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Polymarket Stocks

Market Sentiment

Returns the service-level Polymarket market sentiment snapshot across all tracked stocks when you want a single Polymarket-wide market state instead of per-ticker rankings. It includes service-wide buzz, sentiment split, activity trend, breadth metrics and the top drivers by current buzz_score.

buzz_score here means relative Polymarket market heat, not pure bullishness. It measures how hot overall Polymarket stock-market activity is versus Polymarket's own trailing 90-day baseline:

around 50 = normal market activity
higher = more active than usual
lower = quieter than usual

trend is flow momentum over the current 3 UTC days vs previous 3 UTC days using trades, volume, market breadth and liquidity; not price movement. For from/to, anchors at to (or now when to is today).

Use sentiment_score, bullish_pct and bearish_pct for direction.

get/polymarket/stocks/v1/market-sentiment

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Response

Successful Response

buzz_scorenumber nullable required

Service-wide Polymarket heat score relative to the service's trailing 90-day baseline. Around 50 = normal activity, higher values = hotter-than-usual Polymarket activity.

trend'rising' | 'falling' | 'stable' nullable

Flow momentum over the current 3 UTC days vs previous 3 UTC days using trades, volume, market breadth and liquidity; not price movement. Null when the selected window has no measurable Polymarket heat. For from/to, anchors at to (or now when to is today).

trade_countinteger required

Service-wide trade count in the selected period

market_countinteger required

Sum of ticker-level catalog lifetime-overlap market counts in the selected UTC window; not a cross-ticker global condition-id union

current_market_countinteger required

Sum of ticker-level currently open markets in the latest UTC-day snapshot; use this for live-only market breadth

unique_tradersinteger nullable

Exact service-wide observed participant/proxy-wallet union in the selected period; null when retained wallet-level trades do not fully cover the requested window

total_liquiditynumber required

Windowed aggregated liquidity signal in USD over the selected period

active_tickersinteger required

Number of tickers with market activity in the selected period

sentiment_scorenumber nullable

Service-wide weighted orderbook-aware implied sentiment score

positive_countinteger required

Deprecated. Outcome-aware bullish market count retained for v1 compatibility; prefer bullish_pct with trade_count and market_count for public analysis.

negative_countinteger required

Deprecated. Outcome-aware bearish market count retained for v1 compatibility; prefer bearish_pct with trade_count and market_count for public analysis.

neutral_countinteger required

Deprecated. Outcome-aware neutral/unclassified market count retained for v1 compatibility; prefer bullish_pct, bearish_pct, trade_count and market_count for public analysis.

bullish_pctinteger required

Outcome-aware bullish market percentage

bearish_pctinteger required

Outcome-aware bearish market percentage

trend_historynumber[]

Daily service-wide buzz scores (oldest→newest) using the same relative baseline calibration. Length = max(requested_days, 7) for successful requests; windows before platform availability return HTTP 422.

Example response

{
  "buzz_score": 58.4,
  "trend": "stable",
  "trade_count": 512,
  "market_count": 93,
  "current_market_count": 64,
  "unique_traders": 281,
  "total_liquidity": 245000,
  "active_tickers": 31,
  "sentiment_score": 0.11,
  "positive_count": 41,
  "negative_count": 29,
  "neutral_count": 23,
  "bullish_pct": 44,
  "bearish_pct": 31,
  "trend_history": [
    52.1,
    54,
    56.8,
    59.2,
    61,
    60.1,
    58.4
  ],
  "drivers": [
    {
      "ticker": "AAPL",
      "trade_count": 52,
      "buzz_score": 68.9,
      "sentiment_score": 0.28
    },
    {
      "ticker": "TSLA",
      "trade_count": 47,
      "buzz_score": 66.3,
      "sentiment_score": 0.19
    }
  ]
}