{"uid":"cap__DWVBTZx6u3_ZvMzVjkJV","slug":"aisa-mpp-data-apis-polymarket-user-positions-4b78e970","name":"Polymarket User Positions","description":"Returns current positions for a user.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/positions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["user"],"properties":{"user":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User address (required)"},"limit":{"type":"integer","default":100,"maximum":500,"minimum":0},"title":{"type":"string","maxLength":100},"market":{"type":"array","items":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"0x-prefixed 64-hex string"},"description":"Comma-separated list of condition IDs. Mutually exclusive with eventId."},"offset":{"type":"integer","default":0,"maximum":10000,"minimum":0},"sortBy":{"enum":["CURRENT","INITIAL","TOKENS","CASHPNL","PERCENTPNL","TITLE","RESOLVING","PRICE","AVGPRICE"],"type":"string","default":"TOKENS"},"eventId":{"type":"array","items":{"type":"integer","minimum":1},"description":"Comma-separated list of event IDs. Mutually exclusive with market."},"mergeable":{"type":"boolean","default":false},"redeemable":{"type":"boolean","default":false},"sizeThreshold":{"type":"number","default":1,"minimum":0},"sortDirection":{"enum":["ASC","DESC"],"type":"string","default":"DESC"},"includeArchived":{"type":"boolean","default":false,"description":"Include positions in archived markets that are still active. Archived positions are excluded by default."}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"icon":{"type":"string"},"size":{"type":"number"},"slug":{"type":"string"},"asset":{"type":"string"},"title":{"type":"string"},"cashPnl":{"type":"number"},"endDate":{"type":"string"},"outcome":{"type":"string"},"avgPrice":{"type":"number"},"curPrice":{"type":"number"},"eventSlug":{"type":"string"},"mergeable":{"type":"boolean"},"percentPnl":{"type":"number"},"redeemable":{"type":"boolean"},"conditionId":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"0x-prefixed 64-hex string"},"proxyWallet":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User Profile Address (0x-prefixed, 40 hex chars)"},"realizedPnl":{"type":"number"},"totalBought":{"type":"number"},"currentValue":{"type":"number"},"initialValue":{"type":"number"},"negativeRisk":{"type":"boolean"},"outcomeIndex":{"type":"integer"},"entryFeesUsdc":{"type":"number","description":"Attributed BUY-fee component of `grossInitialValue`, at six-decimal source precision. SELL fees are exit costs and are never included. Returned as an explicit `0` when the fee component is zero. Optional: treat an omitted field as unavailable rather than as zero."},"oppositeAsset":{"type":"string"},"oppositeOutcome":{"type":"string"},"grossInitialValue":{"type":"number","description":"Remaining entry basis including attributed BUY fees, at six-decimal source precision. `initialValue` and `avgPrice` keep their fee-exclusive semantics, so the fee-exclusive basis is `grossInitialValue - entryFeesUsdc`. Optional: treat an omitted field as unavailable rather than as zero."},"percentRealizedPnl":{"type":"number"}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xb_Jb-QRv8lvG0iBn0wif","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Returns current prediction market positions held by a specific Ethereum wallet address on Polymarket, including P&L, prices, and redeemability.","exampleAgentPrompt":"Show me all the current Polymarket positions for wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839, sorted by current value descending, and flag any that are redeemable.","exampleUseCases":[{"title":"Portfolio P&L review for a trader","prompt":"Pull up all current Polymarket positions for wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839 and show me which ones have the biggest percent P&L gains or losses."},{"title":"Finding redeemable winnings to claim","prompt":"Check if wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839 has any Polymarket positions that are redeemable right now so I know what I can cash out."},{"title":"Monitoring exposure in a specific market","prompt":"What positions does 0x56687bf447db6ffa42ffe2204a05edaa20f55839 hold in Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917, and what's the current value?"}],"resultDescription":"An array of position objects for the specified wallet, each containing the market title, outcome bet on, position size in tokens, average entry price, current price, initial and current USDC values, cash and percent P&L, realized P&L, gross initial value with entry fees, whether the position is redeemable or mergeable, the condition ID, end date, and negative risk flag.","failureModes":["Invalid Ethereum address format (not 0x + 40 hex chars) returns validation error","No positions found returns empty array","Mutually exclusive market and eventId both provided causes error","Offset exceeds 10000 maximum returns error","Network or upstream Polymarket API unavailability causes timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need to inspect the current open positions of a specific Ethereum wallet on Polymarket, including P&L metrics, redeemability status, and position sizing. Prefer this over Polymarket's leaderboard endpoint when you need per-position detail for a single address rather than aggregate rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:54.128Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-user-positions-4b78e970"}