{"uid":"cap_HPts-Lsvyx7wHS5iNUbX3","slug":"agentutility-polymarket-markets-search-api-b72ef3ae","name":"AgentUtility Polymarket Markets Search API","description":"Markets API / Polymarket markets / prediction markets list and search. Exact buyer-demand slug backed by Polymarket gamma-api public market data. Filter active/closed markets by query, category, tag, liquidity, sort order, limit, and offset. Returns questions, slugs, outcomes, implied prices, liquidity, volume, and URLs. Data-only; no trading or order routing.","url":"https://x402.agentutility.ai/markets","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."},"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."},"closed":{"type":"boolean","description":"Default false."},"offset":{"type":"number","description":"Pagination offset."},"category":{"type":"string","description":"Filter by Polymarket category substring."},"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"},"outcome_prices":{"type":"array","items":{"type":"number"}}}}},"attribution":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"count":20,"markets":[{"question":"Will X happen?","outcome_prices":[0.42,0.58]}],"attribution":"Data: Polymarket gamma-api. https://polymarket.com"}},"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_G77oFRFuFKO2mtOYKkvsp","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":"Search and filter Polymarket prediction market listings by query, category, tag, liquidity, and sort order, returning questions, outcomes, implied prices, volume, and URLs.","exampleAgentPrompt":"Search Polymarket for active prediction markets about the 2026 US midterm elections — filter to politics category, sort by liquidity descending, and return the top 10 results with their implied prices and slugs.","exampleUseCases":[{"title":"Election probability research","prompt":"Find the top 5 most liquid active prediction markets on Polymarket related to the 2024 US presidential election, and show me the current implied probabilities for each outcome."},{"title":"Crypto event market discovery","prompt":"Search Polymarket for any open prediction markets about Bitcoin ETF approvals or SEC crypto rulings, sorted by volume, and give me the market questions and current prices."},{"title":"Crowd sentiment on AI regulation","prompt":"Look up active Polymarket prediction markets tagged with AI or artificial intelligence, show me the top 10 by liquidity, and include the implied yes/no prices and market URLs."}],"resultDescription":"Returns a list of prediction market objects, each containing the market question, slug, possible outcomes, implied prices per outcome, current liquidity, total volume, and a direct URL to the market on Polymarket. No trading or order execution is included.","failureModes":["No markets found matching the query or filters — returns empty list","Invalid category or tag value — may return empty results or error","Offset/limit out of range — returns empty results","Polymarket gamma-api upstream outage — service unavailable error","Malformed POST body — returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need structured, filterable access to Polymarket prediction market data including implied probabilities and liquidity metrics. Prefer it over direct Polymarket web scraping when you need clean JSON output with sorting and filtering. Use it when an agent needs to inform a user about crowd-sourced event probabilities without executing any trades.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:08:37.909Z","isFirstParty":false}