Raw schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"title": "Page",
"description": "Page number (1-indexed).",
"default": 1
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"description": "Items per page (1-200; default 50). Pass page_size=5 for chat-style summaries.",
"default": 50
},
"spread_min": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Spread Min",
"description": "Minimum bid-ask spread (0-1). Higher = less liquid."
},
"spread_max": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Spread Max",
"description": "Maximum bid-ask spread (0-1). Lower = more liquid."
},
"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."
},
"probability_max": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Probability Max",
"description": "Maximum probability (0-1)."
},
"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."
},
"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)."
},
"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)."
},
"volume_24h_change_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Volume 24H Change Max",
"description": "Maximum 24h notional volume change (signed USD)."
},
"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."
},
"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`."
},
"volume_24hr_min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Volume 24Hr Min",
"description": "Minimum 24h notional volume (USD). Excludes low-activity markets."
},
"volume_24hr_max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Volume 24Hr Max",
"description": "Maximum 24h notional 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."
},
"volume_max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Volume Max",
"description": "Maximum cumulative volume (USD)."
},
"rank_min": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Rank Min",
"description": "Minimum rank score (numeric). Higher = more prominent."
},
"rank_max": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Rank Max",
"description": "Maximum rank score (numeric)."
},
"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`)."
},
"ends_before": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Ends Before",
"description": "Filter to events whose end_date <= this ISO 8601 datetime."
},
"hide_ended": {
"type": "boolean",
"title": "Hide Ended",
"description": "If true, hide markets/events whose end_date is in the past (end_date <= now()); rows with no end_date are kept.",
"default": false
},
"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."
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"description": "Comma-separated status list; any of {open, closing-soon, resolved}"
},
"search": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Search",
"description": "Full-text search across title, description, slug. Case-insensitive substring match."
},
"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."
},
"categories": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categories",
"description": "Comma-separated category labels to include (OR)"
},
"categories_exclude": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categories Exclude",
"description": "Comma-separated category labels to exclude"
},
"hide_price_derivatives": {
"type": "boolean",
"title": "Hide Price Derivatives",
"description": "If true, exclude events with is_price_derivative=TRUE",
"default": false
},
"include_uncategorized": {
"type": "boolean",
"title": "Include Uncategorized",
"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).",
"default": false
},
"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."
},
"countries_exclude": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Countries Exclude",
"description": "Comma-separated country names to exclude."
},
"include_uncountried": {
"type": "boolean",
"title": "Include Uncountried",
"description": "If true, the include clause also matches rows whose countries array is empty/NULL β country-agnostic markets (synthetic 'No country' bucket).",
"default": false
},
"country_match": {
"type": "string",
"pattern": "^(any|all)$",
"title": "Country Match",
"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.",
"default": "any"
}
},
"required": []
}