{"uid":"cap_tRhToEI5BsgE8GyYiGvKX","slug":"polymarket-wallet-trades-mito-trade-3ce9b3fc","name":"Polymarket Wallet Trades — mito.trade","description":"Polymarket prediction-market data API (x402 paid): wallet positions, trades, holders, market trades, klines, and markets. USDC on Polygon, Base, or Arbitrum.","url":"https://data.mito.trade/x402/v1/wallet/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"],"type":"string"},"queryParams":{"type":"object","required":["wallet","market_id"],"properties":{"limit":{"type":"string","description":"Page size (default 100, max 1000)"},"offset":{"type":"string","description":"Pagination offset"},"wallet":{"type":"string","description":"Ethereum wallet address"},"market_id":{"type":"string","description":"Condition / market id (0x hex)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"total":{"type":"integer"},"trades":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"block_number":0,"block_timestamp":0},"count":0,"total":0,"trades":[]}},"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__JXHjpW86OIJNLY6dW9NC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain trade history for a specific wallet address on a given Polymarket prediction market, paginated, via x402 micropayment.","exampleAgentPrompt":"Pull all trades that wallet 0xAbC1234...5678 made on Polymarket market 0xDef9876...5432 — show me the first 100.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of trade records for the specified wallet and market, along with a count of records returned, total number of trades, and the most recent block number and timestamp seen. Trades include on-chain details for each buy/sell event on the prediction market.","failureModes":["Missing required wallet or market_id parameter returns a 400 error","Invalid wallet address format causes rejection","Invalid market_id hex string causes rejection","Payment not submitted or insufficient USDC causes 402 Payment Required","Market ID that does not exist may return empty trades array","Offset beyond total count returns empty trades array","Rate limits or payment failures from x402 facilitator"],"whenToPreferThis":"Use this endpoint when you need paginated, on-chain trade history for a specific wallet address on a specific Polymarket prediction market. Prefer this over general Polymarket APIs when you need block-level provenance (block number, block timestamp) or when accessing data programmatically via x402 micropayment on Polygon/Base/Arbitrum. Best for auditing a participant's trading activity or analyzing position-building on a given market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:22.594Z","isFirstParty":false}