{"uid":"cap_qOoAav7SGMIY10xTTgxSS","slug":"vextorium-polymarket-wallet-positions-24d2a3fd","name":"Vextorium Polymarket Wallet Positions","description":"Open positions of a wallet on Polymarket: market, outcome, shares, average and current price, value, PnL (USD and %), redeemable flag and close date, with portfolio totals.","url":"https://api.vextorium.com/v1/polymarket-wallet?utm_source=zero.xyz","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":{"required":["wallet"],"properties":{"limit":{"type":"integer"},"wallet":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"detail":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"slug":{"type":["null","string"]},"close":{"type":["null","string"]},"market":{"type":["null","string"]},"result":{"type":["null","string"]},"stakes":{"type":["null","number"]},"pnl_pct":{"type":["null","number"]},"pnl_usd":{"type":["null","number"]},"avg_price":{"type":["null","number"]},"value_usd":{"type":["null","number"]},"chargeable":{"type":["boolean","null"]},"invested_usd":{"type":["null","number"]},"current_price":{"type":["null","number"]}}}},"source":{"type":["string","null"]},"wallet":{"type":["string","null"]},"positions":{"type":["number","null"]},"total_pnl_usd":{"type":["number","null"]},"total_value_usd":{"type":["number","null"]},"total_invested_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"detail":[{"slug":"will-mark-cuban-win-the-2028-democratic-presidential-nomination-329","close":"2028-11-08","market":"Will Mark Cuban win the 2028 Democratic presidential nomination?","result":"Yes","stakes":1715833.79,"pnl_pct":-38.89,"pnl_usd":-6005.42,"avg_price":0.009,"value_usd":9437.09,"chargeable":false,"invested_usd":15442.5,"current_price":0.0055},{"slug":"will-dwayne-the-rock-johnson-win-the-2028-democratic-presidential-nomination","close":"2028-11-08","market":"Will Dwayne 'The Rock' Johnson win the 2028 Democratic presidential nomination?","result":"Yes","stakes":744429.11,"pnl_pct":6.75,"pnl_usd":541.02,"avg_price":0.0107,"value_usd":8560.93,"chargeable":false,"invested_usd":8019.91,"current_price":0.0115}],"source":"Polymarket (public data API)","wallet":"0x5d189e816b4149be00977c1a3c8840374aec4972","positions":267,"total_pnl_usd":-684338.04,"total_value_usd":85687.7,"total_invested_usd":770025.71}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NJmkTZX1tys5_xkgDRZ59","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves all open prediction market positions, PnL, and portfolio summary for a given Polymarket wallet address","exampleAgentPrompt":"Pull up all the Polymarket positions and PnL for wallet 0x5d189e816b4149be00977c1a3c8840374aec4972 — I want to see what markets they're betting on, their current value, and total profit or loss.","exampleUseCases":[{"title":"Polymarket whale portfolio research","prompt":"Look up the Polymarket positions for wallet 0xABC123... and tell me which markets they're betting on, how much they've invested, and their total profit or loss so far."},{"title":"Track own prediction market returns","prompt":"Can you check my Polymarket wallet 0x5d189e816b4149be00977c1a3c8840374aec4972 and show me how my positions are performing — I want total PnL in USD and a breakdown of each open bet."},{"title":"Competitive trader analysis","prompt":"I want to analyze the top 10 positions for Polymarket wallet 0xDEF456... — show me the markets, average entry prices, current prices, and which ones are up or down."}],"resultDescription":"Returns a full portfolio snapshot for the wallet: list of individual market positions (slug, market question, result side, stakes, average buy price, current price, value in USD, invested USD, PnL in USD and percent), plus aggregate totals (total positions count, total invested USD, total current value USD, total PnL USD), and the data source attribution.","failureModes":["Invalid or malformed wallet address returns an error","Wallet with no Polymarket activity returns empty positions array","Polymarket public API downtime causes upstream failure","Rate limiting if called excessively in short intervals","Limit parameter ignored or capped at platform maximum"],"whenToPreferThis":"Use this endpoint when you need a complete view of a Polymarket wallet's prediction market activity, including open positions, entry prices, current market prices, and realized/unrealized PnL. Prefer this over generic on-chain lookups when the goal is specifically Polymarket portfolio analysis rather than raw token balances or transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:51:57.616Z","isFirstParty":false,"canonicalSlug":"vextorium-polymarket-wallet-positions-24d2a3fd"}