{"uid":"cap_oTKmsA8iTKyjIH9sn6gWd","slug":"polymarket-wallet-open-positions-1c7e7f26","name":"Polymarket Wallet Open 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/polymarket-cartera-pago?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":{"limite":{"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":{"fuente":{"type":["string","null"]},"cartera":{"type":["string","null"]},"detalle":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"slug":{"type":["null","string"]},"cierre":{"type":["null","string"]},"mercado":{"type":["null","string"]},"pnl_pct":{"type":["null","number"]},"pnl_usd":{"type":["null","number"]},"cobrable":{"type":["boolean","null"]},"resultado":{"type":["null","string"]},"valor_usd":{"type":["null","number"]},"precio_medio":{"type":["null","number"]},"invertido_usd":{"type":["null","number"]},"precio_actual":{"type":["null","number"]},"participaciones":{"type":["null","number"]}}}},"posiciones":{"type":["number","null"]},"pnl_total_usd":{"type":["number","null"]},"valor_total_usd":{"type":["number","null"]},"invertido_total_usd":{"type":["number","null"]}}}}}}},"responseSchema":null,"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_lDKo6mnuuzyXfIbjm4CNk","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":"Returns all open positions for a Polymarket wallet address, including market details, outcome, shares, average and current price, USD value, PnL, redeemability, and portfolio totals.","exampleAgentPrompt":"Can you pull up all the open Polymarket positions for wallet 0xABC123... and show me the PnL, current value, and whether any positions are redeemable?","exampleUseCases":[{"title":"Personal Polymarket portfolio review","prompt":"Show me all my open Polymarket positions for wallet 0x4f9a3d2b1e7c5a8f0d3e6b2c9a1d4f7e8b0c5a3d — I want to see the market name, how many shares I hold, my average buy price, current price, USD value, and my profit or loss on each one."},{"title":"Tracking a trader's prediction market bets","prompt":"I want to monitor what markets the Polymarket whale wallet 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b is currently betting on — show me their open positions, how much they've invested, current value, and total PnL."},{"title":"Check which positions can be redeemed for payout","prompt":"For my Polymarket wallet 0xDeAdBeEf1234567890abcdef1234567890abcdef, which of my open positions have resolved and are now redeemable for payout? Show me the close dates and the amounts I can collect."}],"resultDescription":"A JSON object containing wallet address, list of open positions (each with market slug, market name, outcome, shares held, average price paid, current price, USD value invested, current USD value, PnL in USD, PnL as percentage, redeemable flag, and close date), plus portfolio-level totals for number of positions, total invested, total current value, and total PnL in USD.","failureModes":["Invalid or malformed wallet address returns empty positions array or error","Wallet with no Polymarket activity returns zero positions and zero totals","Polymarket API unavailability causes upstream fetch failure","Rate limiting or timeout if Polymarket data source is slow","limite parameter ignored or mishandled if not a positive integer"],"whenToPreferThis":"Use this endpoint when you need detailed open-position data for a specific Polymarket wallet, including per-market PnL, share counts, price comparisons, redeemability status, and aggregated portfolio totals. Prefer this over generic blockchain explorers when you want Polymarket-specific semantic data (outcomes, market names, PnL) rather than raw on-chain token balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:45.492Z","isFirstParty":false,"canonicalSlug":"polymarket-wallet-open-positions-1c7e7f26"}