v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Polymarket Stocks

Trending stocks

Returns the stocks with the strongest Polymarket prediction-market activity in the selected period, ranked by buzz_score.

Includes:

buzz_score: normalized 0-100 activity score used for ranking; bullish and bearish market activity can both rank highly
trend: 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)
sentiment_score, bullish_pct, bearish_pct: outcome-aware market sentiment signals
trade_count, market_count, unique_traders, total_liquidity: activity, breadth, observed participation and liquidity signals
trend_history: independent UTC-day buzz scores, oldest to newest; minimum 7 values. For a closed single-day window with an available final Daily score, the final value equals buzz_score; live and multi-day values can differ. Missing days are 0.0

get/polymarket/stocks/v1/trending

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.

limitinteger

Maximum stocks to return

Example:20

Maximum stocks to return

offsetinteger

Number of items to skip

type'stock' | 'etf' | 'all' nullable

Filter by asset type. Omit or use 'all' for all assets.

Example:stock

Filter by asset type. Omit or use 'all' for all assets.

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name from ticker_reference

buzz_scorenumber nullable required

Polymarket activity/flow discovery score (0-100); not directional sentiment

trend'rising' | 'falling' | 'stable' required

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).

trade_countinteger required

Trade count in selected period

market_countinteger required

Distinct markets that existed for ticker within the selected UTC window, counted by market-catalog lifetime overlap

current_market_countinteger required

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

unique_tradersinteger nullable

Exact distinct union of observed proxy and explicit maker wallet hashes for the delivered scope and UTC window; null when retained wallet-level trades do not fully cover the window; not a complete market-wide participant census

sentiment_scorenumber nullable

Orderbook-aware implied sentiment (-1 to +1); null when no directional sentiment evidence exists in the selected period

bullish_pctinteger required

Outcome-aware bullish market percentage

bearish_pctinteger required

Outcome-aware bearish market percentage

total_liquiditynumber required

Windowed aggregated liquidity signal in USD over the selected period; not a current snapshot

trend_historynumber[]

Recent buzz history (oldest→newest). Length follows the resolved period, with a minimum of 7 values. Closed historical windows end at to.

Example response

[
  {
    "ticker": "TSLA",
    "company_name": "Tesla, Inc.",
    "buzz_score": 71.4,
    "trend": "rising",
    "trade_count": 312,
    "market_count": 27,
    "current_market_count": 12,
    "unique_traders": 119,
    "sentiment_score": 0.34,
    "bullish_pct": 67,
    "bearish_pct": 33,
    "total_liquidity": 94750,
    "trend_history": [
      48.2,
      51,
      55.3,
      61.1,
      65.8,
      69.2,
      71.4
    ]
  }
]