Top Movers
Use when the user wants to see markets with the largest 24h probability swings. Returns the top N movers (default 5, max 20) ranked by absolute prob_24h_change, among open markets that moved more than 2 points on over 1,000 units of 24h volume, one per event. Takes the /markets filters; Climate and Weather and Mentions are always left out. Price-derivative markets are included unless hide_price_derivatives=true. Useful for 'what changed today?' style queries.
Request
- Base URL: https://api.pdata.world
- URL: https://api.pdata.world/api/v1/markets/top-movers
- Auth: none declared
Query parameters
Number of results to return (1-20; default 5).
Minimum bid-ask spread (0-1). Higher = less liquid.
Maximum bid-ask spread (0-1). Lower = more liquid.
Minimum probability (0-1). Filters to markets above this implied probability.
Maximum probability (0-1).
Minimum 24h probability change (-1 to 1, signed). Use 0.15 for >=15pp positive moves.
Maximum 24h probability change (-1 to 1, signed).
Minimum 24h notional volume change (signed USD; e.g. 1000 means +$1k vs prior 24h).
Maximum 24h notional volume change (signed USD).
Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
Filter by active flag (true/false).
Filter by closed flag (true/false). Open markets are closed=false.
Minimum 24h notional volume (USD). Excludes low-activity markets.
Maximum 24h notional volume (USD).
Minimum cumulative volume (USD). Excludes low-activity markets across full history.
Maximum cumulative volume (USD).
Minimum rank score (numeric). Higher = more prominent.
Maximum rank score (numeric).
Filter to events whose end_date >= this ISO 8601 datetime (e.g. 2026-06-01T00:00:00Z).
Filter to events whose end_date <= this ISO 8601 datetime.
If true, hide markets/events whose end_date is in the past (end_date <= now()); rows with no end_date are kept.
Filter to rows whose created_at >= this ISO 8601 datetime (first appearance in pdata's database).
Filter to rows whose created_at <= this ISO 8601 datetime.
Comma-separated status list; any of {open, closing-soon, resolved}
Full-text search across title, description, slug. Case-insensitive substring match.
Field name; prefix '-' for descending order (e.g. -volume_24hr). Common allowed values: volume_24hr, normalized_vol_24hr, liquidity, end_date, closed_time, updated_at. Markets endpoints additionally accept probability, prob_24h_change, spread. Invalid values return 400.
Comma-separated category labels to include (OR)
Comma-separated category labels to exclude
If true, exclude events with is_price_derivative=TRUE
If true, the include clause also matches rows whose categories array is empty/NULL or contains only labels outside the canonical set (synthetic 'Other' bucket).
Comma-separated country names to include (OR). Full English names per the AI categorizer's prompt — e.g. 'United States', 'United Kingdom', 'European Union'. No allow-list — misspelled values silently yield zero matches.
Comma-separated country names to exclude.
If true, the include clause also matches rows whose countries array is empty/NULL — country-agnostic markets (synthetic 'No country' bucket).
How multiple countries combine: 'any' (default, OR — tagged with any selected country) or 'all' (AND — tagged with all of them, e.g. both Iran and Israel). Markets carry ≤3 country tags.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.