{"uid":"cap_j_3MVrZbq-s09GUaaZWFE","slug":"blockrun-ai-27eca808","name":"BlockRun.AI Polymarket Historical Trades","description":"Query historical Polymarket trade data with flexible filtering","url":"https://blockrun.ai/api/v1/pm/polymarket/trades","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{}}},"response":{"_truncated":true,"_originalSize":90062}},"exampleRequest":{"input":{"body":{}}},"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.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hO-IMmDJiyMeThyVj1D0T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Query historical trade data from Polymarket prediction markets with flexible filtering options","exampleAgentPrompt":"Can you pull the historical trade data from Polymarket for the 'Will Trump win the 2024 election?' market so I can see all the buy and sell activity?","exampleUseCases":null,"resultDescription":"Returns a structured dataset of historical Polymarket trade records, including trade timestamps, market identifiers, wallet addresses, direction (buy/sell), share quantities, prices, and transaction details. The response can be large (original size ~72KB), containing multiple trade entries filterable by market or wallet.","failureModes":["No trades found for the given filter parameters — returns empty data array","Invalid market ID or wallet address format — returns error or empty result","Rate limiting or quota exceeded — returns 402 or 429 error","Network timeout for large trade history queries","Missing required filter parameters resulting in unscoped or overly large response"],"whenToPreferThis":"Use this endpoint when you need raw historical trade-level data from Polymarket — individual buy/sell events with timestamps, prices, and wallet info. Prefer this over the OHLCV candlestick endpoint when you need granular trade records rather than aggregated price bars, or over the wallet analytics endpoint when you want market-wide trade history rather than a single wallet's performance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:46:09.968Z","isFirstParty":false}