{"uid":"cap_7Mb2cEeL_Cqkrm3tS33N7","slug":"arkham-x402-polymarket-positions-c1b89db3","name":"Arkham x402 – Polymarket Positions","description":"Get Arkham Polymarket positions for a wallet. $0.60 per call.","url":"https://api.arkm.com/x402/polymarket/positions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["addr"],"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)."},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Max results (default 50, max 1000)."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Offset for pagination (default 0)."},"sortBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Column to order by: trades (default), shares, value, pnl."},"sortOrder":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort direction: asc or desc (default)."}},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}]}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":["x402","finance"],"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":{"p10Cents":"60.0000","medianCents":"60.0000","p90Cents":"60.0000","minCents":"60.0000","maxCents":"60.0000","p95Cents":"60.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_jqiDlNnqE7l1mcZZqy25v","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 wallet's open Polymarket prediction-market positions including net flow, unrealized P&L, last price, and trade count, charged per-request via x402 micropayment.","exampleAgentPrompt":"Pull up all current Polymarket positions for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 — I want to see which markets they're in, their net position sizes, and unrealized P&L on each.","exampleUseCases":[{"title":"Track a whale's prediction market bets","prompt":"Look up the Polymarket positions for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 and tell me which events they're betting on, how large their positions are, and whether they're up or down on each."},{"title":"Monitor trader's sports market exposure","prompt":"I want to see every open sports market position that address 0xBDDF61Af533fF524D27154e589d2D7A81510C684 holds on Polymarket, including the last price and total number of trades they've made on each."},{"title":"Audit a wallet's Polymarket P&L","prompt":"Check what Polymarket markets wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684 is currently in and show me the unrealized P&L and net USDC flow for each position so I can assess their overall profitability."}],"resultDescription":"Returns a JSON object containing an array of position objects — each with the event ID, outcome label, market question, image URL, last traded price, net USDC flow, net position size, total trade count, condition ID, token address, and unrealized P&L — plus a total count and the queried wallet address.","failureModes":["Invalid or malformed wallet address returns an error or empty positions array","Wallet has no Polymarket activity — returns positions array with zero items and totalCount 0","Insufficient x402 payment (under $0.60 USDC) causes request to be rejected with a 402 Payment Required response","Rate limiting or network errors on the Arkham API side may return 5xx errors","Querying a non-Ethereum or unsupported address format may produce an error response"],"whenToPreferThis":"Use this endpoint when you specifically need on-chain Polymarket position data attributed to a known wallet address, including financial metrics like unrealized P&L and net USDC flow. Prefer this over generic Polymarket APIs when you need Arkham's wallet intelligence layer (address labeling, entity attribution) combined with position data, and when pay-per-request x402 billing is acceptable over a subscription model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:17:21.759Z","isFirstParty":false,"canonicalSlug":"arkham-x402-polymarket-positions-c1b89db3"}