v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Polymarket Stocks

Trending countries

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

Includes:

buzz_score: normalized 0-100 activity score used for ranking
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)
trade_count, market_count, unique_traders, total_liquidity: activity, breadth, observed participation and liquidity signals
sentiment_score, bullish_pct, bearish_pct: outcome-aware market sentiment signals
top_tickers: up to 5 tickers driving the country result

get/polymarket/stocks/v1/trending/countries

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 countries to return

Example:20

Maximum countries to return

offsetinteger

Number of items to skip

Response

Successful Response

buzz_scorenumber nullable required

Aggregated activity/flow buzz score using trades, volume, breadth, liquidity and participation

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

Total trade count in period

market_countinteger required

Sum of ticker-level catalog lifetime-overlap market counts in the selected UTC window for this dimension; not a cross-ticker 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_tickersinteger required

Unique tickers in dimension

unique_tradersinteger nullable

Exact distinct union of observed proxy and explicit maker wallet hashes for the dimension and UTC window; null when retained wallet-level trades do not fully cover the window

sentiment_scorenumber nullable

Weighted implied sentiment; null when no underlying trades exist 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[] required

Daily dimension buzz scores (oldest to newest). Length follows the resolved period, with a minimum of 7 values. Every slot describes only its UTC calendar day. The live final value describes today so far and can differ from period buzz_score. Closed historical windows end at to.

top_tickersstring[] required

Top 5 tickers by trade_count

countrystring required

Country name

Example response

[
  {
    "buzz_score": 70.1,
    "trend": "stable",
    "trade_count": 712,
    "market_count": 265,
    "current_market_count": 129,
    "unique_tickers": 10,
    "unique_traders": 402,
    "sentiment_score": 0.18,
    "bullish_pct": 58,
    "bearish_pct": 42,
    "total_liquidity": 472000,
    "trend_history": [
      52.1,
      54,
      56.8,
      59.2,
      61,
      60.1,
      70.1
    ],
    "top_tickers": [
      "AAPL",
      "TSLA",
      "NVDA",
      "AMZN",
      "GOOGL"
    ],
    "country": "United States"
  }
]