{"uid":"cap_vl6XSvdIOeFa4DB7SsDIZ","slug":"x402-polymarket-markets-1369cb48","name":"x402 Polymarket Markets","description":"Search or list active Polymarket prediction markets, ranked by 24h volume","url":"https://agentx402pay.com/api/polymarket-markets?utm_source=zero.xyz","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":{"q":{"type":"string","description":"Optional keyword filter on the market question"},"limit":{"type":"string","description":"Max markets to return, 1-50 (default 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aE-9W0TyxGwb6aF1_Bafg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search or list active Polymarket prediction markets ranked by 24-hour trading volume","exampleAgentPrompt":"Show me the top 10 most-traded Polymarket prediction markets right now — filter them to anything related to elections.","exampleUseCases":[{"title":"Tracking top political prediction markets","prompt":"What are the 20 most active Polymarket markets about politics or elections right now?"},{"title":"Discovering crypto outcome markets","prompt":"Find me Polymarket prediction markets related to crypto or Bitcoin — show up to 15, sorted by volume."},{"title":"Daily market briefing for a forecaster","prompt":"Give me a list of the top 10 active Polymarket markets by 24-hour volume so I can see what traders are most focused on today."}],"resultDescription":"A ranked list of active Polymarket prediction markets sorted by 24-hour trading volume, including market questions, slugs, volume metrics, and other market metadata. Supports optional keyword filtering and configurable result limits (1–50, default 10).","failureModes":["No markets match the keyword query — returns empty list","limit parameter out of range (must be 1–50) — may return error or default","Polymarket data source unavailable — upstream timeout or error response","Payment not processed — x402 payment required before data is returned"],"whenToPreferThis":"Use this endpoint when you need to discover or browse active Polymarket prediction markets, especially when you want to find markets by topic keyword or identify the highest-volume markets of the day. Prefer this over the Polymarket Market Detail endpoint when you don't yet know the specific market slug and need to search or explore. Prefer this over Kalshi Markets when the user specifically wants Polymarket (crypto-native, global, non-regulated) rather than regulated US event contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:35:35.457Z","isFirstParty":false,"canonicalSlug":"x402-polymarket-markets-1369cb48"}