{"uid":"cap_Z5gL6HFSIYD4I1G68BK7n","slug":"prediction-markets-search-filter-api-dfb376ad","name":"Prediction Markets Search & Filter API","description":"Search, filter, and sort prediction markets across exchanges.","url":"https://d2ngmd5yvdfkqu.cloudfront.net/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":null,"example":null,"exampleRequest":null,"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_KGzwlbxmoQM7Nb6QRfg0G","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 multiple exchanges (Kalshi, Polymarket, Gemini) with rich query parameters.","exampleAgentPrompt":"Search for open binary prediction markets about AI or technology on Polymarket, sorted by 24-hour volume descending, and show me the top 10 results.","exampleUseCases":null,"resultDescription":"A paginated list of prediction market events matching the query, including market names, event tickers, exchange identifiers, volume statistics (1hr, 24hr, total), open interest in USD, trade counts, market status, outcome types, and PMCS category codes. Useful for discovering, comparing, and tracking active prediction markets across exchanges.","failureModes":["Invalid entity_code returns empty results or 400 error","Unknown pmcs_category or pmcs_supersector code returns empty results","Malformed volume filter strings (non-numeric) may return 400","Pagination offset beyond total results returns empty list","Free-text search with no matching markets returns empty array","Payment not attached or insufficient — 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to discover, search, or filter prediction markets across multiple exchanges with flexible criteria (text search, volume, open interest, category, exchange, outcome type). Prefer this over the similar-markets endpoint when you don't have a seed event_ticker and need broad discovery. Use this over exchange-native APIs when you need cross-exchange aggregation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:35.711Z","isFirstParty":false}