{"uid":"cap_emhsRGLxQuDHq3EMG7Ujx","slug":"arkham-polymarket-wallet-pnl-summary-a5bc1605","name":"Arkham Polymarket Wallet PnL Summary","description":"Get Arkham Polymarket wallet PnL summary. $0.40 per call.","url":"https://api.arkm.com/x402/polymarket/wallet/summary/pnl","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":{"totalPnl":"1112457.739498369","marketsWon":700,"realizedPnl":"1108849.771518","userAddress":"0xBDDF61Af533fF524D27154e589d2D7A81510C684","marketsTotal":1435,"uniqueMarkets":1348,"deployedCapital":"84658193.540001"}},"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_Pp75jdI5Ym0w5IXsxcW76","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 a Polymarket wallet's profit/loss summary including total PnL, realized PnL, markets won, total markets, unique markets, and deployed capital.","exampleAgentPrompt":"Pull the Polymarket PnL summary for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see total PnL, realized PnL, how many markets they've won, and how much capital they've deployed.","exampleUseCases":[{"title":"Research top Polymarket trader performance","prompt":"Look up the full PnL summary for Polymarket wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to know their total profit, realized gains, and how many prediction markets they've participated in."},{"title":"Due diligence on a prediction market whale","prompt":"I'm considering copying trades from a Polymarket address. Can you check 0xBDDF61Af533fF524D27154e589d2D7A81510C684's win rate, total PnL, and deployed capital so I can evaluate how good they actually are?"},{"title":"Competitive analysis of rival Polymarket accounts","prompt":"Get me the PnL breakdown for these two Polymarket wallets so I can compare their realized profits, total markets traded, and how much capital each has deployed — starting with 0xBDDF61Af533fF524D27154e589d2D7A81510C684."}],"resultDescription":"Returns a JSON object with the wallet's Polymarket performance metrics: totalPnl (all-time net profit/loss), realizedPnl (locked-in gains/losses), marketsWon (number of markets resolved in favor of the user), marketsTotal (total markets entered), uniqueMarkets (distinct market contracts interacted with), deployedCapital (total USDC deployed across all markets), and userAddress (the queried wallet address).","failureModes":["Invalid or non-existent wallet address returns empty or error response","Wallet has no Polymarket activity — returns zero values across all fields","Payment failure or insufficient USDC balance via x402 results in 402 Payment Required","Rate limiting or API key issues return 401/403 errors","Malformed request body causes 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need a comprehensive PnL and performance summary for a specific Polymarket wallet address. It is ideal for evaluating trader profitability, researching prediction market whales, or building leaderboards. Prefer this over general blockchain explorers when you need Polymarket-specific metrics like marketsWon, uniqueMarkets, and deployedCapital in a single structured response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:37.242Z","isFirstParty":false}