{"uid":"cap_1bqDDyoO1xuft9FuKJXr2","slug":"polymarket-search-api-x402-agentutility-ai-ae04fa8e","name":"Polymarket Search API (x402.agentutility.ai)","description":"Searches Polymarket prediction markets by question, description, and slug over the returned market page, with optional category/tag/liquidity filters. Data-only; no betting, trading, or order execution. Use it as a Polymarket search API or market query endpoint.","url":"https://x402.agentutility.ai/polymarket-search","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."},"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'."},"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":{"slug":{"type":"string"},"question":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":10,"markets":[{"slug":"will-ai-company-ipo","question":"Will an AI company IPO?"}]}},"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_ZRnxS0dHrXRJ7NdO_5Y56","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":"Searches Polymarket prediction markets by question text, description, or slug with optional category, tag, and liquidity filters — returns market data only, no trading.","exampleAgentPrompt":"Search Polymarket for prediction markets about the 2024 US presidential election — filter to markets with meaningful liquidity and show me the top results including their questions and slugs.","exampleUseCases":[{"title":"Researching election prediction markets","prompt":"Find all Polymarket prediction markets related to the 2024 US presidential election — I want to see the market questions, descriptions, and any available category tags."},{"title":"Monitoring crypto price forecast markets","prompt":"Search Polymarket for any active markets predicting Bitcoin price milestones or ETH price targets — filter to markets that have decent liquidity so I know they're actively traded."},{"title":"Discovering AI industry prediction markets","prompt":"Can you query Polymarket for prediction markets about artificial intelligence topics — things like AI regulation, model releases, or company milestones? Show me the slugs and descriptions."}],"resultDescription":"A list of Polymarket prediction markets matching the search criteria, including market questions, descriptions, slugs, category/tag labels, and liquidity data. Results are read-only market data with no order or trade execution.","failureModes":["No markets found matching query — returns empty results","Invalid or unsupported filter parameters — may return error or unfiltered results","Polymarket data unavailability — upstream data fetch failure","Payment failure via x402 protocol — call not executed","Rate limiting or quota exceeded — request rejected"],"whenToPreferThis":"Use this endpoint when an AI agent needs to discover or search Polymarket prediction markets programmatically, especially when filtering by topic, category, tag, or liquidity without needing to place trades or access order books. Prefer over scraping Polymarket directly because it provides a structured, agent-friendly API 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:37.357Z","isFirstParty":false}