{"uid":"cap_HuwBshuCVMERbcgRkB12L","slug":"prediction-market-recent-trades-feed-b1c0e2e1","name":"Prediction Market Recent Trades Feed","description":"Recent trades for one prediction market (by conditionId, slug or numeric id): a PII-stripped pseudonymous feed plus a derived summary — trade count, buy/sell volume and counts, size-weighted average price, last price and range.","url":"https://payai.agentstools.dev/prediction/trades","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":["market"],"properties":{"side":{"enum":["BUY","SELL"],"type":"string","description":"Filter to one side"},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Max trades (default 25, cap 100)"},"venue":{"enum":["polymarket"],"type":"string","description":"Venue (default polymarket)"},"market":{"type":"string","description":"Market: 0x conditionId, slug or numeric id (resolved to a conditionId first)"},"min_size":{"type":"number","minimum":0,"description":"Only trades at/above this cash value"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lYyv7XMYqTjj2W7oHSjtD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a pseudonymous recent-trades feed for a prediction market (by conditionId, slug, or numeric ID) with a derived summary of trade count, volume, price stats, and buy/sell breakdown.","exampleAgentPrompt":"Show me the last 50 trades on the Polymarket market with slug 'will-trump-win-2024', filtering to only BUY trades above $5, and give me the average price and total volume breakdown.","exampleUseCases":null,"resultDescription":"A pseudonymous list of recent trades (up to 100) for the specified prediction market, plus a derived summary including total trade count, buy and sell volumes and counts, size-weighted average price, last traded price, and price range over the returned window.","failureModes":["Market not found for given conditionId, slug, or numeric ID — returns 404 or empty result","Invalid side filter value (not BUY or SELL) — schema validation error","limit out of range (below 1 or above 100) — validation error","min_size is negative — validation error","Venue other than polymarket specified — not supported","Payment not provided or insufficient — x402 payment required response","Network or upstream Polymarket API unavailability — 5xx error"],"whenToPreferThis":"Use this endpoint when you need a recent trade-level view of a specific Polymarket prediction market, including pseudonymous individual trades and derived statistics like buy/sell breakdown, average price, and last price. Prefer this over order book endpoints when you want historical trade flow rather than current market depth, and over aggregate market endpoints when you need granular trade-by-trade data or directional volume analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:02:30.902Z","isFirstParty":false}