{"uid":"cap_-nL_3J7y64mfYS0cRrZxp","slug":"polymarket-wallet-positions-api-223f1bad","name":"Polymarket Wallet Positions API","description":"Current open Polymarket positions for a wallet: market, outcome, size, average price, current value and unrealized PnL. Free Polymarket Data API. Pass a proxy wallet address.","url":"https://proxy.suverse.io/v1/data/polymarket-wallet-positions","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BQmE_zUC5oXLd2Uv453oP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current open Polymarket prediction market positions for a given proxy wallet address, including market details, outcome, size, average price, current value, and unrealized PnL.","exampleAgentPrompt":"What are the current open Polymarket positions for the proxy wallet address 0xABC123...? I want to see each market, my outcome, position size, average entry price, current value, and unrealized PnL.","exampleUseCases":[{"title":"Track personal Polymarket portfolio PnL","prompt":"Can you pull up all my open Polymarket positions for wallet 0x1234abcd...? I want to see each market I'm in, what outcome I bet on, how big my position is, and whether I'm up or down right now."},{"title":"Monitor a trader's prediction market activity","prompt":"Look up the current Polymarket positions for this wallet address 0xdeadbeef... — I'm trying to see what markets they're holding, their average entry prices, and what their unrealized PnL looks like across each position."},{"title":"Portfolio snapshot before Polymarket event resolution","prompt":"Before the election market resolves tonight, can you show me all open positions for wallet 0x9f8e7d... on Polymarket, including the current value and how much I stand to gain or lose?"}],"resultDescription":"A list of currently open Polymarket positions for the specified wallet, each containing: the prediction market name, the chosen outcome, position size, average purchase price, current market value of the position, and unrealized profit or loss (PnL).","failureModes":["Invalid or unrecognized proxy wallet address returns empty results or error","Wallet with no open positions returns an empty array","Network or upstream Polymarket API outage causes timeout or 5xx error","Malformed request body (missing required fields) returns 400 bad request","Payment failure (insufficient USDC balance) blocks the request via x402 protocol"],"whenToPreferThis":"Use this endpoint when you need real-time open position data for a specific Polymarket wallet, including unrealized PnL and current market value. Prefer this over general blockchain explorers when you specifically need structured Polymarket position data in a ready-to-use format without parsing raw on-chain data yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:02:17.986Z","isFirstParty":false}