{"uid":"cap_RH-7RFhtPgNK5tVOEYkVv","slug":"polymarket-filter-api-88fb5f89","name":"Polymarket Filter API","description":"Polymarket filter API / filter prediction markets by category, query, tag, status, liquidity, and sort order. Market-data filter only; it does not filter wallets by trade history.","url":"https://x402.agentutility.ai/polymarket-filter","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"count":25,"markets":[{"question":"Will team X win?","outcome_prices":[0.51,0.49]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PoZFXOHXOqh95D5S45u1q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Filters Polymarket prediction markets by category, query text, tag, status, liquidity, and sort order to return matching market listings","exampleAgentPrompt":"Can you find me open Polymarket prediction markets about the 2024 US presidential election, sorted by highest liquidity?","exampleUseCases":[{"title":"Research political prediction markets","prompt":"Search Polymarket for all active prediction markets about the 2024 US election, filtered to only those with significant liquidity, sorted by volume — I want to see what the crowd is betting on."},{"title":"Monitor crypto event markets","prompt":"Find me any open Polymarket markets tagged with 'Bitcoin' or 'crypto' that are currently active and sort them by most recent so I can track what events people are predicting."},{"title":"Discover resolved AI prediction markets","prompt":"Pull up all resolved Polymarket prediction markets in the AI or technology category so I can review past forecasts and see how accurate they were."}],"resultDescription":"Returns a filtered list of Polymarket prediction market objects including market names, current probabilities, liquidity values, status (open/closed/resolved), tags, and category metadata matching the specified filter criteria.","failureModes":["Invalid or unsupported category value returns empty results or error","Overly restrictive liquidity filter returns zero markets","Payment not processed — x402 USDC payment failure prevents response","Malformed query string causes 400 error","Polymarket upstream data unavailable causes 503 or stale results"],"whenToPreferThis":"Choose this endpoint when an agent needs to discover or browse Polymarket prediction markets programmatically by category, tag, or keyword — especially useful for research, monitoring, or surfacing relevant markets to users. Prefer this over scraping Polymarket directly because it handles filtering, sorting, and normalization in one call and is designed for autonomous agent consumption with USDC micropayment settlement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:20.833Z","isFirstParty":false}