{"uid":"cap_COMpxXBzuxMWB2qNa4si8","slug":"arkham-x402-polymarket-wallet-summary-stats-1f3e0d01","name":"Arkham x402 Polymarket Wallet Summary Stats","description":"Get Arkham Polymarket wallet stats summary. $0.40 per call.","url":"https://api.arkm.com/x402/polymarket/wallet/summary/stats","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"addr":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Required. Polymarket trade address (0x + 40 hex chars)."}}},"responseSchema":{"type":"json","example":{"totalFees":"24948.9331","totalEvents":395407,"totalTrades":395407,"totalVolume":"89383319.07563","userAddress":"0xBDDF61Af533fF524D27154e589d2D7A81510C684","firstActiveAt":"2025-11-07T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4qnF5j03X_xPdInfz18B8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregate trading statistics for a given Polymarket wallet address, including total volume, fees, trades, and first activity date.","exampleAgentPrompt":"Can you pull up the full trading summary for the Polymarket wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see total volume, fees, number of trades, and when they first started trading?","exampleUseCases":[{"title":"Whale wallet due diligence","prompt":"I'm looking at this Polymarket address 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — can you pull their lifetime trading stats so I can see how active they are and how much volume they've done?"},{"title":"Research competitor prediction market trader","prompt":"I want to analyze the Polymarket activity of address 0xABCDEF1234567890ABCDEF1234567890ABCDEF12 — give me their total trades, total volume, fees paid, and when they first became active on the platform."},{"title":"Monitor own Polymarket account stats","prompt":"Can you fetch my Polymarket wallet summary for 0x1234567890ABCDEF1234567890ABCDEF12345678 so I can see my all-time trading volume and fee totals?"}],"resultDescription":"A JSON object containing the wallet's cumulative Polymarket statistics: totalVolume (USD string), totalTrades (integer count), totalEvents (integer count), totalFees (USD string), userAddress (checksummed hex), and firstActiveAt (ISO 8601 timestamp of first trade).","failureModes":["Invalid or malformed wallet address returns an error","Wallet address with no Polymarket activity may return zero values or a not-found error","Payment failure via x402 protocol blocks the request","Rate limiting if too many requests are made in a short period","Network timeout if the Arkham backend is slow to respond"],"whenToPreferThis":"Use this endpoint when you need a quick, comprehensive aggregate summary of a specific wallet's Polymarket trading history — total volume, fees, trade count, and tenure — in a single call. Prefer this over transaction-level endpoints when you need high-level stats rather than individual trade details, and when on-chain Polymarket data specifically is the target (not general DEX or CEX activity).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:33.327Z","isFirstParty":false}