{"uid":"cap_pgqmHYhbYaFcwJj8BsONL","slug":"polymarket-market-filter-api-19946365","name":"Polymarket Market Filter API","description":"Polymarket filter API / prediction market filter / market screener. Demand-matching route for filtering Polymarket markets by query, category, tag, liquidity, open/closed status, and sort order. Data-only public market research endpoint; no wallet filtering or trade execution.","url":"https://x402.agentutility.ai/market-filter","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{"tag":{"type":"string","description":"Polymarket tag slug filter, passed through to upstream."},"limit":{"type":"number","description":"1-100. Default 20."},"order":{"enum":["volume24hr","liquidity","endDate","startDate"],"type":"string","description":"Sort field: 'volume24hr', 'liquidity', 'endDate', or 'startDate'. Omit for default gamma-api order."},"query":{"type":"string","description":"Free-text filter applied to question, description, and slug."},"active":{"type":"boolean","description":"Default true. Pass false to include inactive markets."},"closed":{"type":"boolean","description":"Default false. Pass true to include closed markets."},"offset":{"type":"number","description":"Pagination offset."},"category":{"type":"string","description":"Filter by Polymarket category substring, e.g. 'Sports', 'Crypto', 'Politics'."},"ascending":{"type":"boolean","description":"Sort direction when order is set. Default false (descending)."},"min_liquidity":{"type":"number","description":"Minimum liquidity in USD."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"markets":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"liquidity_usd":{"type":"integer"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":20,"markets":[{"question":"Will BTC hit a new all-time high?","liquidity_usd":12000}]}},"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_vqaIcO1N-J_cDTs5YwDl5","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 and screens Polymarket prediction markets by query, category, tag, liquidity, open/closed status, and sort order to return matching market data.","exampleAgentPrompt":"Search Polymarket for open prediction markets about the 2024 US election, filter to those with at least $10,000 in liquidity, and sort by volume descending.","exampleUseCases":[{"title":"Political market research screening","prompt":"Find me all open Polymarket prediction markets tagged with 'politics' or related to the US election — sort them by liquidity so I can see the most active ones first."},{"title":"Crypto prediction market discovery","prompt":"Search Polymarket for any open markets about Bitcoin or Ethereum price predictions, filter to only high-liquidity ones, and give me the full list with their current status."},{"title":"Closed market outcome review","prompt":"Pull up a list of recently closed Polymarket markets in the sports category, sorted by newest, so I can review what outcomes were resolved."}],"resultDescription":"A filtered list of Polymarket prediction markets matching the specified criteria, including market names, categories, tags, liquidity values, open/closed status, and sort-ordered results.","failureModes":["No markets match the specified filters — returns empty list","Invalid category or tag values — may return error or empty results","Polymarket API downstream unavailability — endpoint returns error","Payment not processed — request rejected due to unpaid x402 microtransaction","Query string too ambiguous — may return broad or irrelevant market set"],"whenToPreferThis":"Choose this endpoint when you need to programmatically discover, screen, or research Polymarket prediction markets by any combination of keyword, category, tag, liquidity, or status without needing wallet integration or trade execution. It is a pure data/read endpoint ideal for market research agents, information dashboards, or decision-support workflows that need structured Polymarket data on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:21.367Z","isFirstParty":false}