{"uid":"cap_mKUYukYJi7dkRg9odD-iG","slug":"polymarket-trades-feed-5719211f","name":"Polymarket Trades Feed","description":"Recent trades from any Polymarket market (by slug or conditionId) or for a specific wallet. Returns side, size, price, timestamp, trader pseudonym, on-chain tx hash, and computed notional USD. A data-only Polymarket trade feed for prediction-market and on-chain bet-history research.","url":"https://x402.agentutility.ai/polymarket-trades","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{"side":{"enum":["BUY","SELL"],"type":"string","description":"Filter by side."},"user":{"type":"string","description":"Polymarket proxy wallet address to filter by. Optional."},"limit":{"type":"number","description":"1-500. Default 50."},"market":{"type":"string","description":"Market slug (e.g. 'will-x-happen') OR conditionId (0x...). Optional."},"offset":{"type":"number","description":"Pagination offset."},"after_ts":{"type":"number","description":"Unix seconds. Only trades after."},"before_ts":{"type":"number","description":"Unix seconds. Only trades before."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"trades":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string"},"outcome":{"type":"string"},"tx_hash":{"type":"string"},"price_usd":{"type":"number"},"timestamp":{"type":"integer"},"market_slug":{"type":"string"},"size_shares":{"type":"integer"},"notional_usd":{"type":"integer"},"trader_pseudonym":{"type":"string"}}}},"attribution":{"type":"string"},"total_notional_usd":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"count":20,"trades":[{"side":"BUY","outcome":"Yes","tx_hash":"0xabc...","price_usd":0.42,"timestamp":1779033805,"market_slug":"will-x-happen","size_shares":100,"notional_usd":42,"trader_pseudonym":"agent_one"}],"attribution":"Data: Polymarket data-api. https://polymarket.com","total_notional_usd":840}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PzK-2w7NgDwPLD2zcvQ_m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent on-chain trades from a Polymarket prediction market by market slug or conditionId, or for a specific wallet address, returning side, size, price, timestamp, trader pseudonym, tx hash, and notional USD.","exampleAgentPrompt":"Pull the most recent trades for the Polymarket market with slug 'will-trump-win-2024' — I want to see who bought YES vs NO, at what prices, and the on-chain tx hashes.","exampleUseCases":[{"title":"Monitor a hot prediction market","prompt":"Show me the latest trades on the Polymarket market for 'will-the-fed-cut-rates-in-june' — I want to see the prices, trade sizes, and whether people are buying YES or NO."},{"title":"Audit a wallet's betting history","prompt":"Can you pull all recent Polymarket trades for wallet address 0xABC123...def and show me what bets they've placed, at what prices, and the transaction hashes?"},{"title":"Track price action by conditionId","prompt":"Get me the recent trade feed for Polymarket conditionId 0x7f4e...b2c1 — I need side, price, size, and notional USD for each trade to see how the market has moved."}],"resultDescription":"A list of recent trade records, each containing: trade side (YES/NO buy or sell), size (shares), price (implied probability), timestamp, trader pseudonym, on-chain transaction hash, and computed notional value in USD.","failureModes":["Invalid or unknown market slug returns empty results or error","Invalid conditionId format causes a 400-level error","Wallet address with no Polymarket activity returns empty trade list","Rate limiting or payment failure (insufficient USDC balance) returns 402 or 429","Polymarket data source unavailable causes timeout or 503"],"whenToPreferThis":"Use this endpoint when you need granular, trade-level data from Polymarket — including on-chain tx hashes, trader pseudonyms, and notional USD — rather than just market prices or order book snapshots. Ideal for trade history audits, wallet tracking, or feeding a trading analytics pipeline. Prefer over scraping Polymarket's UI or using less structured data sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:33.107Z","isFirstParty":false}