closing_soon

Use when the user wants to see markets that will resolve within the next 36 hours. Returns markets sorted by close timestamp ascending. Takes the /markets filters, e.g. `source=` and `categories=` (CSV); price-derivative markets are included unless `hide_price_derivatives=true`.

read-only

Argument	Type	Description
sort	any	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.
limit	integer	Number of results to return (1-20; default 5).
active	any	Filter by `active` flag (true/false).
closed	any	Filter by `closed` flag (true/false). Open markets are `closed=false`.
search	any	Full-text search across title, description, slug. Case-insensitive substring match.
source	any	Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
status	any	Comma-separated status list; any of {open, closing-soon, resolved}
rank_max	any	Maximum rank score (numeric).
rank_min	any	Minimum rank score (numeric). Higher = more prominent.
countries	any	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.
categories	any	Comma-separated category labels to include (OR)
ends_after	any	Filter to events whose end_date >= this ISO 8601 datetime (e.g. `2026-06-01T00:00:00Z`).
hide_ended	boolean	If true, hide markets/events whose end_date is in the past (end_date <= now()); rows with no end_date are kept.
spread_max	any	Maximum bid-ask spread (0-1). Lower = more liquid.
spread_min	any	Minimum bid-ask spread (0-1). Higher = less liquid.
volume_max	any	Maximum cumulative volume (USD).
volume_min	any	Minimum cumulative volume (USD). Excludes low-activity markets across full history.
ends_before	any	Filter to events whose end_date <= this ISO 8601 datetime.
country_match	string	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.
created_after	any	Filter to rows whose created_at >= this ISO 8601 datetime (first appearance in pdata's database).
created_before	any	Filter to rows whose created_at <= this ISO 8601 datetime.
probability_max	any	Maximum probability (0-1).
probability_min	any	Minimum probability (0-1). Filters to markets above this implied probability.
volume_24hr_max	any	Maximum 24h notional volume (USD).
volume_24hr_min	any	Minimum 24h notional volume (USD). Excludes low-activity markets.
countries_exclude	any	Comma-separated country names to exclude.
categories_exclude	any	Comma-separated category labels to exclude
include_uncountried	boolean	If true, the include clause also matches rows whose countries array is empty/NULL — country-agnostic markets (synthetic 'No country' bucket).
prob_24h_change_max	any	Maximum 24h probability change (-1 to 1, signed).
prob_24h_change_min	any	Minimum 24h probability change (-1 to 1, signed). Use 0.15 for >=15pp positive moves.
include_uncategorized	boolean	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).
volume_24h_change_max	any	Maximum 24h notional volume change (signed USD).
volume_24h_change_min	any	Minimum 24h notional volume change (signed USD; e.g. 1000 means +$1k vs prior 24h).
hide_price_derivatives	boolean	If true, exclude events with is_price_derivative=TRUE

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sort",
      "description": "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."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "Number of results to return (1-20; default 5)."
    },
    "active": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Active",
      "description": "Filter by `active` flag (true/false)."
    },
    "closed": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Closed",
      "description": "Filter by `closed` flag (true/false). Open markets are `closed=false`."
    },
    "search": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Search",
      "description": "Full-text search across title, description, slug. Case-insensitive substring match."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source",
      "description": "Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini."
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Status",
      "description": "Comma-separated status list; any of {open, closing-soon, resolved}"
    },
    "rank_max": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank Max",
      "description": "Maximum rank score (numeric)."
    },
    "rank_min": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rank Min",
      "description": "Minimum rank score (numeric). Higher = more prominent."
    },
    "countries": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries",
      "description": "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."
    },
    "categories": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Categories",
      "description": "Comma-separated category labels to include (OR)"
    },
    "ends_after": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ends After",
      "description": "Filter to events whose end_date >= this ISO 8601 datetime (e.g. `2026-06-01T00:00:00Z`)."
    },
    "hide_ended": {
      "type": "boolean",
      "title": "Hide Ended",
      "default": false,
      "description": "If true, hide markets/events whose end_date is in the past (end_date <= now()); rows with no end_date are kept."
    },
    "spread_max": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Spread Max",
      "description": "Maximum bid-ask spread (0-1). Lower = more liquid."
    },
    "spread_min": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Spread Min",
      "description": "Minimum bid-ask spread (0-1). Higher = less liquid."
    },
    "volume_max": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume Max",
      "description": "Maximum cumulative volume (USD)."
    },
    "volume_min": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume Min",
      "description": "Minimum cumulative volume (USD). Excludes low-activity markets across full history."
    },
    "ends_before": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ends Before",
      "description": "Filter to events whose end_date <= this ISO 8601 datetime."
    },
    "country_match": {
      "type": "string",
      "title": "Country Match",
      "default": "any",
      "pattern": "^(any|all)$",
      "description": "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."
    },
    "created_after": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Created After",
      "description": "Filter to rows whose created_at >= this ISO 8601 datetime (first appearance in pdata's database)."
    },
    "created_before": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Created Before",
      "description": "Filter to rows whose created_at <= this ISO 8601 datetime."
    },
    "probability_max": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Probability Max",
      "description": "Maximum probability (0-1)."
    },
    "probability_min": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Probability Min",
      "description": "Minimum probability (0-1). Filters to markets above this implied probability."
    },
    "volume_24hr_max": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume 24Hr Max",
      "description": "Maximum 24h notional volume (USD)."
    },
    "volume_24hr_min": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume 24Hr Min",
      "description": "Minimum 24h notional volume (USD). Excludes low-activity markets."
    },
    "countries_exclude": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Countries Exclude",
      "description": "Comma-separated country names to exclude."
    },
    "categories_exclude": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Categories Exclude",
      "description": "Comma-separated category labels to exclude"
    },
    "include_uncountried": {
      "type": "boolean",
      "title": "Include Uncountried",
      "default": false,
      "description": "If true, the include clause also matches rows whose countries array is empty/NULL — country-agnostic markets (synthetic 'No country' bucket)."
    },
    "prob_24h_change_max": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": -1
        },
        {
          "type": "null"
        }
      ],
      "title": "Prob 24H Change Max",
      "description": "Maximum 24h probability change (-1 to 1, signed)."
    },
    "prob_24h_change_min": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1,
          "minimum": -1
        },
        {
          "type": "null"
        }
      ],
      "title": "Prob 24H Change Min",
      "description": "Minimum 24h probability change (-1 to 1, signed). Use 0.15 for >=15pp positive moves."
    },
    "include_uncategorized": {
      "type": "boolean",
      "title": "Include Uncategorized",
      "default": false,
      "description": "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)."
    },
    "volume_24h_change_max": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume 24H Change Max",
      "description": "Maximum 24h notional volume change (signed USD)."
    },
    "volume_24h_change_min": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Volume 24H Change Min",
      "description": "Minimum 24h notional volume change (signed USD; e.g. 1000 means +$1k vs prior 24h)."
    },
    "hide_price_derivatives": {
      "type": "boolean",
      "title": "Hide Price Derivatives",
      "default": false,
      "description": "If true, exclude events with is_price_derivative=TRUE"
    }
  }
}

get_event

Use when an agent needs the full detail of a single prediction-market event by its composite key (source + event_id). Returns the event with all of its child markets, latest probabilities, and metadata. The canonical URL `https://pdata.world/events/{source}/{event_id}` is stable for the lifetime of the underlying market. Events that closed more than 10 days ago are removed from the live tables; the same URL then returns a `kind: "tombstone"` object holding the title, close date and final outcome of each top market instead of the live `kind: "live"` object. Check `kind` before reading any other field. Large events carry hundreds of markets (a 311-market event is ~520 KB); pass `markets_limit` to take only the first N.

read-only

Argument	Type	Description
source*	string	Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini.
event_id*	string	Event ID native to the source. URL-encoded if it contains special chars.
markets_limit	any	Return only the first N markets, in the order described under `markets`; `markets_total` still counts all of them. Omit to get every market. Ignored for a tombstone.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source",
    "event_id"
  ],
  "properties": {
    "source": {
      "type": "string",
      "title": "Source",
      "description": "Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini."
    },
    "event_id": {
      "type": "string",
      "title": "Event Id",
      "description": "Event ID native to the source. URL-encoded if it contains special chars."
    },
    "markets_limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 500,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Markets Limit",
      "description": "Return only the first N markets, in the order described under `markets`; `markets_total` still counts all of them. Omit to get every market. Ignored for a tombstone."
    }
  }
}

get_event_similar

Use when an agent needs events similar to a given event — cross-platform equivalents and topically-related markets, precomputed nightly from title embeddings. Best-first; empty list (never an error) when no similarities are known yet.

read-only

Argument	Type	Description
limit	integer	Max similar events to return.
source*	string	Platform id, e.g. kalshi.
event_id*	string	Event id native to the source.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source",
    "event_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 8,
      "description": "Max similar events to return."
    },
    "source": {
      "type": "string",
      "title": "Source",
      "description": "Platform id, e.g. kalshi."
    },
    "event_id": {
      "type": "string",
      "title": "Event Id",
      "description": "Event id native to the source."
    }
  }
}

get_market

Use when an agent needs the full detail of a single market by its composite key (source + market_id). Returns the market with its parent event reference, current probability, volume, 24h delta, and historical chart points. Includes a `_meta.cite_as` field that the agent can drop directly into its reply.

read-only

Argument	Type	Description
source*	string	Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini.
market_id*	string	Market ID native to the source. Composite key with `source`.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source",
    "market_id"
  ],
  "properties": {
    "source": {
      "type": "string",
      "title": "Source",
      "description": "Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini."
    },
    "market_id": {
      "type": "string",
      "title": "Market Id",
      "description": "Market ID native to the source. Composite key with `source`."
    }
  }
}

get_summary

Use when an agent needs platform-level context before drilling into individual markets: one row per platform (Polymarket, Kalshi, Manifold, Myriad, Limitless, Predict, Opinion, Gemini) carrying 24h notional volume, active event and market counts, and that platform's category mix. Takes no parameters and returns the whole picture in one small response, which makes it the cheapest way to answer 'how big is X relative to Y' or 'which platform covers this topic'. Volumes are in each platform's native units — Manifold reports play-money mana, not USD — so do not sum across platforms without saying so.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {}
}

list_countries

Use when an agent needs the list of country tags that markets have been tagged with. Returns the canonical country vocabulary with per-country market counts. Accepts the same filter params as `list_markets` (source, category, status, volume/probability ranges, search, …): the counts then reflect that filtered population, so this doubles as a facet endpoint. The country dimension itself is ignored when computing counts, so passing `country=` does not collapse the menu. Useful as the menu source for the `country=` filter on `list_events` / `list_markets` / `top_movers`.

read-only

Argument	Type	Description
sort	any	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.
active	any	Filter by `active` flag (true/false).
closed	any	Filter by `closed` flag (true/false). Open markets are `closed=false`.
search	any	Full-text search across title, description, slug. Case-insensitive substring match.
source	any	Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
status	any

list_events

Use when an agent wants to browse, filter, or search prediction-market events across all 8 platforms. Returns paginated events with their child markets, prices, and platform metadata. Filterable by source (polymarket/kalshi/manifold/myriad/limitless/predict/opinion/gemini), category, country, status (open/closed), and full-text search via `search`. Sortable by `volume_24hr`, `normalized_vol_24hr`, `liquidity`, `end_date`, or `closed_time` (prefix `-` for descending). Cap `page_size` ≤ 50 to keep responses small enough for LLM context windows.

read-only

Argument	Type	Description
page	integer	Page number (1-indexed).
sort	any	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.
active	any	Filter by `active` flag (true/false).
closed	any	Filter by `closed` flag (true/false). Open markets are `closed=false`.
search	any	Full-text search across title, description, slug. Case-insensitive substring match.
source	any	Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.

list_markets

Use when the user wants to browse, filter, or sort individual markets (not events). Returns paginated markets with their probability, volume, source, parent event ID, and 24h delta. Filterable by source, country, category, status, and full-text `search`. Sortable by `volume_24hr` or `probability`. Cap `page_size` ≤ 50 for chat-friendly responses.

read-only

Argument	Type	Description
page	integer	Page number (1-indexed).
sort	any	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.
active	any	Filter by `active` flag (true/false).
closed	any	Filter by `closed` flag (true/false). Open markets are `closed=false`.
search	any	Full-text search across title, description, slug. Case-insensitive substring match.
source	any	Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
status	any	Comma-separated status list; any of {open, closing-soon, resolved}

list_news_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`.

read-only

Argument	Type	Description
q	any	Full-text search across market title and event title. Case-insensitive substring match.
page	integer	Page number (1-indexed).
source	any	Platform ID(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
window	integer	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.
ordering	string	Sort order. Allowed values: `vol` (volume-weighted score; default), `score` (raw spike score), `prob` (probability change magnitude).

map_heat

Use when you need a geographic snapshot of where prediction-market attention is concentrated. Returns per-country heat (capped news score, summed) for the current moment (`at=now`) or a past hour (`at=<ISO8601>`).

read-only

Argument	Type	Description
at	string	'now' (live cache) or an ISO-8601 timestamp for a past hourly frame.
source	any	Restrict to one source (only honored when at=now): polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "at": {
      "type": "string",
      "title": "At",
      "default": "now",
      "description": "'now' (live cache) or an ISO-8601 timestamp for a past hourly frame."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source",
      "description": "Restrict to one source (only honored when at=now): polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini."
    }
  }
}

map_timeline

Use when you need the hourly total-heat time series that drives the /map playback scrubber. History accretes from launch (no backfill).

read-only

Argument	Type	Description
source	any	Reserved; playback history is source_scope='all' in v1.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source",
      "description": "Reserved; playback history is source_scope='all' in v1."
    }
  }
}

news_movers_by_category

Use when the user wants the news feed bucketed by category. Returns the same data shape as `list_news_movers` but pre-grouped into the canonical 14-category vocabulary, with cluster grouping inside each bucket. Useful for 'what's moving in politics?' style queries.

read-only

Argument	Type	Description
q	any	Full-text search across market title and event title. Case-insensitive substring match.
source	any	Platform ID(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.
min_score	any	Minimum spike score. Higher = more notable spikes only.
per_category	integer	Max items per category bucket (1-50; default 11).
include_crypto	boolean	Include crypto price-derivative markets (default: excluded).
include_sports	boolean	Include sports markets (default: excluded).
include_weather	boolean	Include weather markets (default: excluded).
include_resolved

search_suggest

Use when an agent has a name or phrase and needs the `(source, id)` of the matching event or market before calling another tool. Resolves free text against events AND markets in one call, best-first, and reports `total_events` / `total_markets` so the agent can tell a precise hit from an ambiguous one. Every row carries `event_path`, the internal link to use for follow-up lookups. Prefer this over running `list_events?search=` and `list_markets?search=` separately when the goal is identification rather than a filtered listing. Note: `headline` carries literal `<b>` highlight markup — quote `title` instead, or strip the tags.

read-only

Argument	Type	Description
q*	string	Free-text query, matched against event titles and market questions. Queries shorter than 2 characters deliberately return an empty result set rather than half the dataset.
limit	integer	Maximum number of coalesced results to return (1-20, default 8). `total_events` / `total_markets` in the envelope are uncapped and reflect the full match count, not this limit.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "title": "Q",
      "maxLength": 200,
      "minLength": 1,
      "description": "Free-text query, matched against event titles and market questions. Queries shorter than 2 characters deliberately return an empty result set rather than half the dataset."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of coalesced results to return (1-20, default 8). `total_events` / `total_markets` in the envelope are uncapped and reflect the full match count, not this limit."
    }
  }
}

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.

read-only

Argument	Type	Description
sort	any	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.
limit	integer	Number of results to return (1-20; default 5).
active	any	Filter by `active` flag (true/false).
closed	any	Filter by `closed` flag (true/false). Open markets are `closed=false`.
search	any	Full-text search across title, description, slug. Case-insensitive substring match.
source	any	Source name(s); single value or comma-separated list. Allowed: polymarket, kalshi, manifold, myriad, limitless, predict, opinion, gemini.

pdata Prediction Markets

Try it

closing_soon

pdata Prediction Markets

Try it

closing_soon

Tools (14)