{"uid":"cap_wRsTJEZcKxbOh8eF1_c1Y","slug":"polymarket-wallet-open-positions-9aba80ae","name":"Polymarket Wallet Open Positions","description":"A wallet's open Polymarket positions. Pass the wallet (proxy) address; cap with limit. Each position returns the market title + outcome, share size, average vs current price, initial vs current USD value, unrealized USD P&L and percent P&L, whether it's redeemable, and the conditionId/slug. For inspecting any trader's live book (e.g. a wallet from predict.leaderboard or predict.whales). Read-only from Polymarket's Data API.","url":"https://2s.io/api/predict/positions","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer","maximum":500,"minimum":1,"description":"Max positions (default 50)."},"address":{"type":"string","maxLength":60,"minLength":8,"description":"Wallet (proxy) address."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["ok","items","total","source"],"properties":{"ok":{"enum":[true],"type":"boolean"},"meta":{"type":"object","required":["address","count"],"properties":{"count":{"type":"integer"},"address":{"type":"string"}},"additionalProperties":false},"items":{"type":"array","items":{"type":"object","required":["title","outcome","size","avgPrice","curPrice","initialValueUsd","valueUsd","pnlUsd","percentPnl","redeemable","conditionId","slug"],"properties":{"size":{"type":"number","nullable":true},"slug":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"pnlUsd":{"type":"number","nullable":true},"outcome":{"type":"string","nullable":true},"avgPrice":{"type":"number","nullable":true},"curPrice":{"type":"number","nullable":true},"valueUsd":{"type":"number","nullable":true},"percentPnl":{"type":"number","nullable":true},"redeemable":{"type":"boolean"},"conditionId":{"type":"string","nullable":true},"initialValueUsd":{"type":"number","nullable":true}},"additionalProperties":false}},"total":{"type":"integer","nullable":true,"description":"Total matching rows upstream; null when unknown."},"source":{"type":"object","required":["provider","url","license"],"properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":{"ok":true,"meta":{"count":1,"address":"example"},"items":[{"size":1,"slug":"example","title":"example","pnlUsd":1,"outcome":"example","avgPrice":1,"curPrice":1,"valueUsd":1,"percentPnl":1,"redeemable":false,"conditionId":"example","initialValueUsd":1}],"total":1,"source":{"url":"example","license":"example","provider":"example"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q3EO4x0GNQjiECA0Jy4el","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all open prediction market positions for a given Polymarket wallet address, including P&L, share sizes, and redeemability status.","exampleAgentPrompt":"Pull up all the open Polymarket positions for wallet address 0x1234abcd...wxyz — show me the market titles, share sizes, average vs current price, and unrealized P&L for each, up to 100 positions.","exampleUseCases":null,"resultDescription":"A list of open positions for the specified wallet, each containing market title and outcome label, number of shares held, average purchase price vs current market price, initial and current USD value, unrealized dollar P&L and percentage P&L, whether the position is redeemable, and the conditionId and market slug for reference.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Wallet has no open positions — returns empty array","Limit parameter out of range (must be 1–500) causes validation error","Polymarket Data API downtime causes 5xx or timeout","Address is a main wallet rather than proxy address — may return no results"],"whenToPreferThis":"Use this endpoint when you need to inspect any Polymarket trader's current open book — e.g. analyzing a whale's positions from a leaderboard, auditing a specific wallet's exposure, or computing portfolio-level P&L across prediction markets. Prefer this over on-chain reads when you need enriched price and P&L metadata without building your own calculation layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:52:44.461Z","isFirstParty":false}