{"uid":"cap_j1M_hgUeWImcC94bkJFRR","slug":"arkham-polymarket-pnl-chart-b5ecd95e","name":"Arkham Polymarket PnL Chart","description":"Get Arkham Polymarket PnL chart. $0.60 per call.","url":"https://api.arkm.com/x402/polymarket/pnl/chart","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"period":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Time period: 24h, 7d, 30d, all. Presets auto-shrink to the wallet's available history; all is portfolio-only. Default:…"},"endTime":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional Unix timestamp in seconds for end of range. For conditionID requests, preset windows derived from endTime must…"},"startTime":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional Unix timestamp in seconds for start of range. Not supported with period=all. Condition-level custom ranges mus…"},"conditionID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Market condition ID (0x-prefixed bytes32 hex). Aggregates across all outcome tokens. Omit for portfolio-level…"},"userAddress":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Polymarket trade address (0x + 40 hex chars)."}}},"responseSchema":{"type":"json","example":{"points":[{"bucket":"2026-06-21T16:00:00Z","cumulativePnl":"1202005.2290561295","cumulativeFees":"0","cumulativePosition":"81139973.2305291295","cumulativeUsdcFlow":"-79937968.001473"},{"bucket":"2026-06-21T20:00:00Z","cumulativePnl":"1196436.8781641535","cumulativeFees":"0","cumulativePosition":"81135956.3163611535","cumulativeUsdcFlow":"-79939519.438197"},{"bucket":"2026-06-22T00:00:00Z","cumulativePnl":"1187960.280146319","cumulativeFees":"0","cumulativePosition":"81127882.209258319","cumulativeUsdcFlow":"-79939921.929112"}],"endTime":"2026-07-21T18:13:19.658980453Z","interval":"4h","startTime":"2026-06-21T18:13:19.658980453Z","userAddress":"0xBDDF61Af533fF524D27154e589d2D7A81510C684"}},"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_yszcZKRC3iyeAE0vBcKIn","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":"Returns a time-series chart of cumulative PnL, fees, position value, and USDC flow for a given Polymarket wallet address over a specified time range and interval.","exampleAgentPrompt":"Pull the Polymarket PnL chart for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 over the last 30 days at 4-hour intervals and show me how their cumulative profit and USDC flow have trended.","exampleUseCases":[{"title":"Track a whale trader's Polymarket performance","prompt":"Show me the cumulative PnL chart for Polymarket wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 over the past month using 4-hour buckets — I want to see if they've been consistently profitable."},{"title":"Audit a prediction market portfolio over an election cycle","prompt":"Get the Polymarket PnL and USDC flow chart for wallet 0xABCD1234... from November 1st to November 30th at daily intervals so I can see how it performed around the election."},{"title":"Monitor my own Polymarket trading results","prompt":"Fetch my Polymarket PnL chart for the last 7 days at 1-hour intervals for wallet 0x1234ABCD... and tell me my total cumulative profit and how much USDC I've moved in and out."}],"resultDescription":"Returns a JSON object containing an array of time-bucketed data points, each with cumulative PnL, cumulative fees, cumulative position value, and cumulative USDC flow. Also includes the wallet address queried, the interval used, and the start and end timestamps of the chart window.","failureModes":["Invalid or unrecognized wallet address returns empty or error response","Insufficient USDC balance for x402 pay-per-request payment causes request rejection","Invalid time interval or malformed date range returns error","Wallet address with no Polymarket activity returns empty points array","Rate limiting or payment processing failure from x402 layer"],"whenToPreferThis":"Use this endpoint when you need granular time-series PnL performance data for a specific Polymarket wallet address, especially when cumulative position sizing and USDC flow history over custom time windows matter. Prefer this over general wallet analytics when the focus is specifically on Polymarket prediction market trading performance rather than broader on-chain activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:01:58.778Z","isFirstParty":false}