{"uid":"cap_Ai1Mj-p1rGmyaLfoOhqJz","slug":"polynews-news-3751e518","name":"Polymarket Real-Time Trade Stream with Market Summaries","description":"Real-time trade stream with market summaries (2hr rolling window, $500+ trades)","url":"https://polynews.news/api/v1/feed","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":{"limit":{"type":"string"},"minValue":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"trades":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"price":{"type":"number"},"amount":{"type":"number"},"market":{"type":"string"},"timestamp":{"type":"number"}}}},"summary":{"type":"object","properties":{"pollCount":{"type":"number"},"newestTimestamp":{"type":"number"},"oldestTimestamp":{"type":"number"},"totalAccumulated":{"type":"number"},"accumulatorUptime":{"type":"number","description":"Seconds"}},"description":"Accumulator stats"},"marketSummaries":{"type":"array"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{"trades":[{"side":"BUY","price":0.32,"amount":2400,"market":"Democratic Presidential Nominee 2028","wallet":"0xa1b2...c3d4","outcome":"Gavin Newsom","valueUsd":768,"timestamp":1747019400}],"marketSummaries":[{"netFlow":7100,"marketId":"69317","buyVolume":45200,"sellVolume":38100,"tradeCount":42}]},"meta":{"tier":"standard","version":"v1","endpoint":"/api/v1/feed","latencyMs":180,"timestamp":"2026-05-12T04:30:00.000Z"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":"10","minValue":"500"}}},"response":{"data":{"trades":[],"summary":{"pollCount":0,"newestTimestamp":1781561922,"oldestTimestamp":1781561274,"totalAccumulated":43,"accumulatorUptime":15},"marketSummaries":[]},"meta":{"tier":"standard","version":"v1","endpoint":"/api/v1/feed","latencyMs":15104,"timestamp":"2026-06-16T01:02:26.654Z"}}},"exampleRequest":{"limit":"10","minValue":"500"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_N-ym2JOqJW3CYpwgTnxOt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a rolling 2-hour real-time stream of Polymarket trades ($500+ in value) with market-level summaries and price/volume data","exampleAgentPrompt":"Pull the latest Polymarket trade stream — show me the 50 most recent trades above $500 from the last 2 hours along with the market summaries.","exampleUseCases":[{"title":"Monitor high-value election prediction trades","prompt":"What are the biggest trades happening right now on Polymarket election markets? Show me the last 2 hours of $500+ trades so I can see where the smart money is moving."},{"title":"Track real-time crypto market sentiment shifts","prompt":"Stream me the latest high-value trades on crypto prediction markets for the next hour — I need to watch the trade flow and volume to spot sentiment changes as they happen."},{"title":"Alert on unusual trading activity spikes","prompt":"Give me a rolling feed of Polymarket trades above $500 from the last 2 hours and flag any markets where trading volume suddenly surged. Show me the market summaries too so I understand what's driving the action."}],"resultDescription":"A JSON object containing an array of recent trades (each with side, price, amount, market ID, and timestamp) and an array of market summaries, covering trades above $500 in a 2-hour rolling window.","failureModes":["No trades available if market activity is low in the rolling window","Invalid limit or minValue query parameter types return schema validation errors","Payment failure (402) if USDC micropayment is not completed via x402 protocol","Empty trades array if no trades exceed the specified minValue threshold","Timeout or stale data if upstream Polymarket data source is unavailable"],"whenToPreferThis":"Use this endpoint when you need raw, real-time trade-level data from Polymarket with a 2-hour rolling window focused on significant trades ($500+). Prefer this over market context or news endpoints when you want pure trade flow and volume data rather than AI-generated analysis or news correlation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:36:57.223Z","isFirstParty":false}