{"uid":"cap_S5TpQwLZvGYL_C1WeM3Y-","slug":"arkham-x402-polymarket-wallet-prediction-history-2c1faf93","name":"Arkham x402 – Polymarket Wallet Prediction History","description":"Get Arkham Polymarket wallet prediction history. $0.60 per call.","url":"https://api.arkm.com/x402/polymarket/wallet/prediction-history","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)."},"sort":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort field: value, volume, currentPrice, trades, pnl, shares, buyUsd, avgBuy, sellUsd, avgSell. Default: pnl. When stat…"},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Results per page (1-100, default 20)."},"order":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort order: asc or desc. Default: desc."},"maxPnl":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum PnL in whole USD (can be negative)."},"minPnl":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum PnL in whole USD (can be negative)."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Offset for pagination (default 0)."},"search":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Search market question, group title, event title, or condition ID."},"status":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter by position state: open or closed."},"eventID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to all markets and outcomes in a Polymarket event."},"maxValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum current held value in whole USD."},"minValue":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum current held value in whole USD."},"maxTrades":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum trade count."},"maxVolume":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum total volume in whole USD."},"minTrades":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum trade count."},"minVolume":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum total volume in whole USD."},"conditionID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to a single market condition ID."},"maxSharesHeld":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum remaining held shares in whole shares."},"minSharesHeld":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum remaining held shares in whole shares."},"maxAvgBuyPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum average buy price as a 0-1 fraction."},"minAvgBuyPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum average buy price as a 0-1 fraction."},"tokenAddresses":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to specific outcome token addresses."},"maxAvgSellPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum average sell price as a 0-1 fraction."},"maxCurrentPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum current price as a 0-1 fraction."},"maxTotalBuyUsdc":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum total buy amount in whole USD."},"minAvgSellPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum average sell price as a 0-1 fraction."},"minCurrentPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum current price as a 0-1 fraction."},"minTotalBuyUsdc":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum total buy amount in whole USD."},"maxTotalSellUsdc":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum total sell amount in whole USD."},"minTotalSellUsdc":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum total sell amount in whole USD."}}},"responseSchema":{"type":"json","example":{"hasMore":true,"markets":[{"pnl":"643126.136941","value":"0","volume":"332768.337261","eventId":401638,"outcome":"No","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/premier+league.jpg","question":"Will Chelsea FC win on 2026-05-04?","netShares":"0","eventTitle":"Chelsea FC vs. Nottingham Forest FC","isResolved":true,"resolvedAt":"2026-05-04T20:20:48Z","sharesHeld":"0","avgBuyPrice":"0.34098803308944694087","conditionId":"0x0433839be2e0889423ff0a0efae939272899d09c284d309b346d3991d003c4c0","totalTrades":71,"avgSellPrice":"1.00000000000000000000","currentPrice":"1","tokenAddress":"0x5f10f068a11aa7c2f4244d8d71bcfd1ad3f2ed337d916960eb2a660ad380f892","totalBuyUsdc":"332768.337261","totalSellUsdc":"975894.474202","groupItemTitle":"Chelsea FC"}],"totalCount":1435,"userAddress":"0xBDDF61Af533fF524D27154e589d2D7A81510C684","totalCountExact":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","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.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8IrBi_HZW43YILZ31uPTA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the full Polymarket prediction market trading history for a given wallet address, including PnL, volume, and resolved market outcomes.","exampleAgentPrompt":"Pull up the full Polymarket prediction history for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see their PnL, total volume, which markets they traded, and how the resolved ones turned out.","exampleUseCases":[{"title":"Trader profitability deep-dive","prompt":"Look up the Polymarket trading history for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 and tell me their total PnL, volume traded, and which markets made them the most money."},{"title":"Due diligence on a prediction whale","prompt":"I'm considering copy-trading this address on Polymarket — can you pull their full prediction history, check their win rate on resolved markets, and summarize how they've performed overall?"},{"title":"On-chain analyst research report","prompt":"Give me a breakdown of all the Polymarket markets that wallet 0xAbCd1234… has participated in, including average buy and sell prices and which outcomes they bet on — I'm writing a report on smart money prediction behavior."}],"resultDescription":"Returns a paginated list of Polymarket markets the wallet has traded in, each including PnL, total buy/sell USDC volume, net shares, average buy and sell prices, outcome bet on, resolution timestamp, event title, question text, condition ID, token address, and image URL. Also includes total count and a hasMore flag for pagination.","failureModes":["Invalid or unrecognized wallet address returns empty results or an error","Wallet with no Polymarket activity returns empty markets array with totalCount 0","Insufficient USDC payment (x402) causes request to be rejected before processing","Rate limiting if too many requests are made in quick succession","Pagination edge cases if totalCountExact is false for very large histories"],"whenToPreferThis":"Use this endpoint when you need granular Polymarket trading history tied to a specific on-chain wallet address, including resolved PnL and per-market breakdowns. Prefer this over generic Polymarket APIs when you also need Arkham's wallet intelligence context or when paying per-request via x402 is acceptable. Best for investigative, research, or copy-trading use cases where depth of history per wallet matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:05.084Z","isFirstParty":false}