{"uid":"cap_2GsOGvLW84ONCLZ3gEJj8","slug":"prediction-market-search-filter-api-ef75e5d2","name":"Prediction Market Search & Filter API","description":"Search, filter, and sort prediction markets across exchanges.","url":"https://api.predictionmarketdata.io/prediction-markets","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"string","description":"Maximum number of events to return."},"offset":{"type":"string","description":"Zero-based pagination offset."},"search":{"type":"string","description":"Free-text query across market and event names."},"status":{"type":"string","description":"Market status. Open is the safest default."},"sort_by":{"type":"string","description":"Sort key, e.g. total_volume_24hr, total_open_interest_usd, end_ts."},"sort_dir":{"type":"string","description":"Sort direction: asc or desc."},"volume_max":{"type":"string","description":"Maximum total volume filter."},"volume_min":{"type":"string","description":"Minimum total volume filter."},"entity_code":{"type":"string","description":"Exchange filter. Common: KALSHI, POLYMARK, GMNI."},"event_ticker":{"type":"string","description":"Exact event identifier (from a prior /prediction-markets response)."},"outcome_type":{"type":"string","description":"Outcome model. Common: Binary, Multi."},"searchString":{"type":"string","description":"Legacy alias for search; prefer search."},"pmcs_category":{"type":"string","description":"Top-level PMCS category code from /prediction-markets/taxonomy."},"queryCriteria":{"type":"string","description":"Legacy advanced query field; prefer search."},"volume_1hr_max":{"type":"string","description":"Maximum 1-hour volume filter."},"volume_1hr_min":{"type":"string","description":"Minimum 1-hour volume filter."},"trade_count_max":{"type":"string","description":"Maximum trade count."},"trade_count_min":{"type":"string","description":"Minimum trade count."},"pmcs_supersector":{"type":"string","description":"PMCS supersector code from /prediction-markets/taxonomy."},"open_interest_max":{"type":"string","description":"Maximum open interest (USD)."},"open_interest_min":{"type":"string","description":"Minimum open interest (USD)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"pagination":{"limit":2,"total":30834,"offset":0,"hasMore":true,"nextOffset":2},"predictionMarkets":[{"end_ts":"2026-06-23T00:30:00Z","is_series":true,"event_name":"Game 3: San Antonio at New York","entity_code":"KALSHI","event_ticker":"KXNBAGAME-26JUN08SASNYK.KALSHI","event_outcomes":[{"status":"Open","volume":7872349.97,"market_id":"KXNBAGAME-26JUN08SASNYK-NYK_yes.KALSHI","percentage":0.54,"outcome_name":"New York"}],"pmcs_categories":["SPT","BSKTBL","NBA"],"event_outcome_type":"Multi","entity_event_category":"Sports"}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":"10","offset":"0","search":"artificial intelligence","status":"open","sort_by":"total_volume_24hr","sort_dir":"desc","outcome_type":"Binary"}}},"response":{"pagination":{"limit":10,"total":0,"offset":0,"hasMore":false},"predictionMarkets":[]}},"exampleRequest":{"limit":"10","offset":"0","search":"artificial intelligence","status":"open","sort_by":"total_volume_24hr","sort_dir":"desc","outcome_type":"Binary"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bDqUTUKwQoojR-BYCmAfm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search, filter, sort, and paginate prediction markets across exchanges like Kalshi, Polymarket, and Gemini.","exampleAgentPrompt":"Search prediction market data for open binary markets related to 'US recession' on Kalshi, sorted by 24-hour volume descending, and return the top 10 results.","exampleUseCases":null,"resultDescription":"A paginated list of prediction market records matching the query, including event tickers, market names, exchange codes, status, open interest in USD, volume metrics (1hr, 24hr, total), trade counts, and outcome types.","failureModes":["Invalid entity_code returns empty results or 400 error","Unrecognized pmcs_category code returns no results — use /prediction-markets/taxonomy to get valid codes","Overly restrictive volume_min/volume_max combo returns empty result set","Invalid sort_by key may return 400 or default sort fallback","Payment not included or insufficient USDC results in 402 payment required error","event_ticker not found returns empty results"],"whenToPreferThis":"Use this endpoint when you need to discover, search, or filter prediction markets across multiple exchanges with flexible criteria like volume thresholds, outcome type, category, or free-text search. Prefer this over exchange-specific APIs when you want cross-exchange visibility. Use sibling endpoints for narrative recaps, similar market discovery, or time-series volume data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:18.326Z","isFirstParty":false}