{"uid":"cap__HFiuPTIicrfA5JJWUmfH","slug":"polypulse-top-polymarket-markets-by-volume-0640136a","name":"PolyPulse: Top Polymarket Markets by Volume","description":"Live Polymarket prediction-market data for AI agents: markets closing soon, biggest movers, top by volume ($0.01 each) and a one-call cross-market digest ($0.02). USDC via x402 on Base.","url":"https://api.polypulse-x402.workers.dev/v1/markets/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","properties":{"q":{"type":"string","maxLength":60,"description":"keyword filter (optional)"},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1},"min_liquidity":{"type":"number","default":0,"minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"source":"Polymarket Gamma API (live, cached <=60s)","markets":[{"url":"https://polymarket.com/event/nfl-pit-cle-2026-10-02","event":"Steelers vs. Browns","spread":0.01,"best_ask":0.58,"best_bid":0.57,"end_date":"2026-10-02T00:15:00Z","outcomes":{"Browns":0.425,"Steelers":0.575},"question":"Steelers vs. Browns","change_1h":0,"yes_price":0.575,"change_24h":0.02,"liquidity_usd":3447209,"volume_24h_usd":516719}],"generated_at":"2026-10-01T15:00:00Z"}},"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_EBG9tyidEMUYqJNK7rjiH","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":"Returns the top Polymarket prediction markets ranked by volume, with live odds, price changes, and liquidity data.","exampleAgentPrompt":"Pull up the top 10 Polymarket prediction markets by volume right now — I want to see live odds, 24-hour price changes, and liquidity for each.","exampleUseCases":[{"title":"Sports betting odds monitoring","prompt":"Show me the top Polymarket sports markets by volume right now — I want to see the current yes/no prices and how much they've moved in the last 24 hours."},{"title":"High-liquidity market discovery","prompt":"Find me Polymarket prediction markets with at least $500,000 in liquidity and show me the top 20 by volume with their current odds."},{"title":"Keyword-filtered market research","prompt":"Search Polymarket for prediction markets related to 'election' and show me the top results with their current prices and 24-hour volume."}],"resultDescription":"A JSON array of top Polymarket prediction markets ranked by volume, each including the market question, event name, outcome probabilities, yes price, best bid/ask, bid-ask spread, 24h and 1h price changes, total liquidity in USD, 24h volume in USD, end date, and a direct Polymarket URL. Also includes total count and cache timestamp.","failureModes":["Polymarket Gamma API upstream outage — returns stale cached data or 502 error","Payment not completed via x402 — returns 402 Payment Required","Invalid query parameters (limit > 50 or < 1) — returns 400 validation error","No markets match the keyword filter — returns empty markets array with count 0","Cache miss during high-traffic period — may return slightly delayed data (up to 60s old)"],"whenToPreferThis":"Use this endpoint when you need the highest-volume or most liquid Polymarket prediction markets in a single call, especially with optional keyword filtering. Prefer this over the 'closing soon' or 'biggest movers' endpoints when your use case is discovering what markets are most actively traded rather than what's about to expire or what's seen the largest price swings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:38:28.982Z","isFirstParty":false,"canonicalSlug":"polypulse-top-polymarket-markets-by-volume-0640136a"}