{"uid":"cap_NFg9ItVOsBEDxBvn9ZI9g","slug":"polymarket-top-markets-67e5cfc3","name":"Polymarket Top Markets","description":"Most active open Polymarket events right now, ranked by 24h volume, total volume or liquidity, optionally by tag (crypto, politics, sports, economy, tech, ai). Each event lists its markets with live probabilities. Use to see what traders are betting on today.","url":"https://bess-x402.onrender.com/v1/predictions/polymarket/top?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"tag":{"type":"string","description":"Polymarket tag slug, e.g. crypto, politics, sports"},"limit":{"type":"integer","description":"Maximum number of results (1-50)"},"order":{"type":"string","description":"volume24hr, volume, liquidity, startDate or endDate"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g3sIzOMx-F6vXKNfOzGFq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most active open Polymarket prediction market events ranked by volume or liquidity, with live probabilities per market, optionally filtered by topic tag.","exampleAgentPrompt":"What are the top 10 Polymarket prediction markets in the politics category right now, ranked by 24-hour volume? Show me the live probabilities for each.","exampleUseCases":[{"title":"Daily prediction market briefing","prompt":"Give me the top 20 Polymarket events ranked by 24-hour volume across all categories — I want to see what traders are most actively betting on today."},{"title":"Crypto market sentiment check","prompt":"Show me the top 15 most liquid Polymarket events in the crypto tag so I can see what outcomes the market thinks are most likely right now."},{"title":"AI prediction market tracker","prompt":"What are the top 10 Polymarket events tagged as AI, ranked by total volume? I want to track what the crowd is betting on in the AI space."}],"resultDescription":"A ranked list of open Polymarket events with their associated markets, each including the event title, market names, current yes/no probabilities, 24h volume, total volume, and liquidity figures. Results are sorted by the requested ordering criterion (volume24hr by default) and capped at the requested limit.","failureModes":["Invalid tag slug returns empty results or an error","Limit out of range (below 1 or above 50) may return an error or be clamped","Invalid order value may return a 400 error","Polymarket data unavailable or stale if upstream API is down","Network timeout from the hosted service on Render under load"],"whenToPreferThis":"Use this endpoint when you need a real-time ranked snapshot of the most active or liquid Polymarket prediction markets, especially when filtering by topic (crypto, politics, sports, economy, tech, AI). Prefer this over manually browsing Polymarket when an agent needs programmatic access to current trader sentiment and probabilities across many events at once.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:44:19.075Z","isFirstParty":false,"canonicalSlug":"polymarket-top-markets-67e5cfc3"}