---
title: "Trending countries"
method: GET
path: "/polymarket/stocks/v1/trending/countries"
tags: ["Polymarket Stocks"]
---

# Trending countries

`GET /polymarket/stocks/v1/trending/countries`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/polymarket/stocks/v1/trending/countries`
- Auth: API key in header `X-API-Key`

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

## Query parameters

- `from` string, date, nullable: Start date in YYYY-MM-DD. Inclusive UTC date.
- `to` string, date, nullable: End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
- `limit` integer: Maximum countries to return
- `offset` integer: Number of items to skip

## Response `200`

Successful Response

- PolymarketTrendingCountry[]
  - `buzz_score` number, 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_count` integer, required: Total trade count in period
  - `market_count` integer, 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_count` integer, required: Sum of ticker-level currently open markets in the latest UTC-day snapshot; use this for live-only market breadth
  - `unique_tickers` integer, required: Unique tickers in dimension
  - `unique_traders` integer, 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_score` number, nullable: Weighted implied sentiment; null when no underlying trades exist in the selected period
  - `bullish_pct` integer, required: Outcome-aware bullish market percentage
  - `bearish_pct` integer, required: Outcome-aware bearish market percentage
  - `total_liquidity` number, required: Windowed aggregated liquidity signal in USD over the selected period; not a current snapshot
  - `trend_history` number[], 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_tickers` string[], required: Top 5 tickers by trade_count
  - `country` string, required: Country name

## Other responses

- `401`: Authentication failed
- `403`: Historical data limit exceeded
- `422`: Invalid period or query parameters
- `429`: Rate limit exceeded
- `503`: Database temporarily unavailable
- `504`: Analytics request deadline exceeded

## Changes

- **2026-09-30** `a74a23b969c4`: 1 info
  - deleted the `query` request parameter `days` with deprecation

[Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/polymarket/stocks/v1/trending/countries/get.md)

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)