news

List Movers

Use when the user wants to see the news-feed view: markets that exhibited a probability spike in the chosen lookback window, scored by |Δprob_pp| × log10(1+USD-equivalent volume). Refreshed after each Polymarket ingest cycle, typically every 15-20 min. The window= param selects the lookback: 24 (default, ≥15pp), 12 (≥12pp), or 2 (≥2h, ≥10pp); prob_change is measured over that window. Includes a prob_history array (24h bucketed trajectory) per row regardless of window. Filterable by source= and categories= (CSV). Soft flags (is_entertainment/is_microprediction/is_crypto/is_sports/is_weather) default OFF; opt in with include_*=true.

get/api/v1/news/movers

Request

  • Base URL: https://api.pdata.world
  • URL: https://api.pdata.world/api/v1/news/movers
  • Auth: none declared

Query parameters

sourcestring nullable

Platform ID(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.

categoriesstring nullable

Category filter (CSV). Examples: 'Politics', 'Sports', 'Crypto', 'Weather'. Maps to events.categories assignments.

qstring nullable

Full-text search across market title and event title. Case-insensitive substring match.

min_scorenumber nullable

Minimum spike score. Higher = more notable spikes only.

include_entertainmentboolean

Include entertainment markets (default: excluded for signal-to-noise).

include_micropredictionboolean

Include microprediction / hyperlocal markets (default: excluded).

include_cryptoboolean

Include crypto price-derivative markets (default: excluded).

include_sportsboolean

Include sports markets (default: excluded).

include_weatherboolean

Include weather markets (default: excluded).

include_resolvedboolean

Include resolved (closed) markets (default: excluded — news movers focus on live markets).

orderingstring

Sort order. Allowed values: vol (volume-weighted score; default), score (raw spike score), prob (probability change magnitude).

window2 | 12 | 24

Lookback windows the carousel selector exposes (hours). An IntEnum (not Literal[2,12,24]) because FastAPI coerces a query STRING to an IntEnum member but NOT to an int literal — ?window=24 would 422 against a Literal even though the Python default 24 validates.

Spike lookback window in hours: 24 (default), 12, or 2. Markets are included if they spiked within this window, and prob_change/score are computed over it. Shorter windows use a lower pp threshold (2h≥10pp, 12h≥12pp, 24h≥15pp) and naturally surface fewer markets.

pageinteger

Page number (1-indexed).

page_sizeinteger

Items per page (1-200; default 50).

Response

Successful Response

countinteger required
pageinteger required
page_sizeinteger required
last_refreshed_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.