{"uid":"cap_kUJDcUwftpDHudocljjeP","slug":"polypulse-polymarket-biggest-movers-c29acb70","name":"PolyPulse: Polymarket Biggest Movers","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/movers?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":{"limit":{"type":"integer","default":15,"maximum":50,"minimum":1},"window":{"enum":["1h","24h"],"type":"string","default":"24h"},"direction":{"enum":["any","up","down"],"type":"string","default":"any"},"min_volume":{"type":"number","default":10000,"minimum":0,"description":"minimum 24h volume (USD)"}}}},"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_VWVSk9iJnsx5mIOXi_F8f","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 Polymarket prediction markets with the largest price movements over a given time window, filtered by direction and minimum volume","exampleAgentPrompt":"Show me the top 20 biggest movers on Polymarket over the last 24 hours, only markets moving upward with at least $10,000 in daily volume.","exampleUseCases":[{"title":"Track surging political prediction markets","prompt":"Which Polymarket prediction markets have surged the most in the last hour? Show me the top 10 with at least $5,000 in 24h volume, moving upward only."},{"title":"Spot crashing sports event markets","prompt":"What are the Polymarket sports or event markets that have dropped the most in the past 24 hours? Give me up to 25 results, minimum $50,000 in volume."},{"title":"Daily briefing on market momentum","prompt":"Give me a snapshot of the 15 biggest Polymarket movers in either direction over the last 24 hours, with at least $10,000 in daily volume, so I can see what's shifting."}],"resultDescription":"A JSON array of prediction market objects sorted by price movement magnitude, each including the market question, event name, current yes price, best bid/ask, spread, 1h and 24h price change, liquidity in USD, 24h volume in USD, outcome probabilities, Polymarket URL, and end date. Also includes a count, data source label, and generation timestamp.","failureModes":["No markets match the specified filters (e.g. very high min_volume with narrow direction) — returns empty markets array with count 0","Polymarket Gamma API temporarily unavailable — may return stale cached data (up to 60 seconds old) or upstream error","Invalid query parameter values (e.g. window not in enum) — likely returns 400 or ignores unknown values","Payment failure via x402/USDC — request not processed if payment not received","Rate limiting if many rapid calls are made without successful payment"],"whenToPreferThis":"Use this endpoint when you need to identify which Polymarket prediction markets are experiencing the most significant price movement over a short time horizon (1h or 24h). It is ideal for momentum tracking, anomaly detection, arbitrage signal discovery, or building a live briefing on fast-moving events. Prefer this over the volume or closing-soon endpoints when your primary interest is price velocity rather than market size or urgency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:38:29.126Z","isFirstParty":false,"canonicalSlug":"polypulse-polymarket-biggest-movers-c29acb70"}