List Markets

Page number (1-indexed).

Items per page (1-200; default 50). Pass page_size=5 for chat-style summaries.

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.