{"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","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)."},"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)."}}},"responseSchema":{"type":"json","example":{"positions":[{"eventId":544680,"outcome":"Boston Red Sox","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/MLB.jpg","question":"Boston Red Sox vs. New York Yankees","lastPrice":0.495,"conditionId":"0x0bbc63372aaf0867db23fc361b4e37f7d3125c7acef6cc8e2d5ce40f65b7e523","netFlowUsdc":"-34690.684786","netPosition":"72272.25996","totalTrades":31,"tokenAddress":"0x535fa6646d139e4b4400ccece2b6d34c1a7d925602f58a5add648030c6f3378f","unrealizedPnl":"1084.0838942"},{"eventId":544680,"outcome":"Under","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/Repetitive-markets/MLB.jpg","question":"Boston Red Sox vs. New York Yankees: O/U 8.5","lastPrice":0.54,"conditionId":"0x717c526bb6a5946f75423352cdbd0d92ab87651710a7740997126d58b3a7925d","netFlowUsdc":"-40596.758127","netPosition":"79601.486519","totalTrades":16,"tokenAddress":"0x15e06d413ac75c0e88e7c0292cfdbf8b767273081f43cb146143dbc5a68ea6dc","unrealizedPnl":"2388.04459326","groupItemTitle":"O/U 8.5"}],"totalCount":5,"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_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-09-15T00:49:10.981Z","isFirstParty":false}