{"uid":"cap_67uVEMU5Myvz3q05ifSFP","slug":"aisa-mpp-data-apis-polymarket-closed-positions-583c3c48","name":"Polymarket Closed Positions","description":"Returns closed 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/closed-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":"The address of the user in question"},"limit":{"type":"integer","default":10,"maximum":50,"minimum":0,"description":"The max number of positions to return"},"title":{"type":"string","maxLength":100,"description":"Filter by market title"},"market":{"type":"array","items":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"0x-prefixed 64-hex string"},"description":"The conditionId of the market in question. Supports multiple csv separated values. Cannot be used with the eventId param."},"offset":{"type":"integer","default":0,"maximum":100000,"minimum":0,"description":"The starting index for pagination"},"sortBy":{"enum":["REALIZEDPNL","TITLE","PRICE","AVGPRICE","TIMESTAMP"],"type":"string","default":"REALIZEDPNL","description":"The sort criteria"},"eventId":{"type":"array","items":{"type":"integer","minimum":1},"description":"The event id of the event in question. Supports multiple csv separated values. Returns positions for all markets for those event ids. Cannot be used with the market param."},"sortDirection":{"enum":["ASC","DESC"],"type":"string","default":"DESC","description":"The sort direction"}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"icon":{"type":"string"},"slug":{"type":"string"},"asset":{"type":"string"},"title":{"type":"string"},"endDate":{"type":"string"},"outcome":{"type":"string"},"avgPrice":{"type":"number"},"curPrice":{"type":"number"},"eventSlug":{"type":"string"},"timestamp":{"type":"integer","format":"int64"},"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"},"outcomeIndex":{"type":"integer"},"oppositeAsset":{"type":"string"},"oppositeOutcome":{"type":"string"}}}},"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_wnhvPa4KxgitMeTAkjvpO","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 a paginated list of closed prediction market positions for a given Polymarket user wallet address, including realized PnL and outcome details.","exampleAgentPrompt":"Pull the top 20 closed positions for Polymarket wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839, sorted by realized PnL from highest to lowest.","exampleUseCases":[{"title":"Review trading performance for a wallet","prompt":"Show me the 10 most profitable closed positions for Polymarket wallet 0xabc123...def456, sorted by realized PnL descending, so I can see which bets paid off the most."},{"title":"Audit closed bets on a specific event","prompt":"Get all the closed positions for wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839 related to event ID 12345 on Polymarket — I want to see how those predictions resolved."},{"title":"Filter closed positions by market title","prompt":"Find the closed Polymarket positions for wallet 0xabc123...def456 where the market title contains 'US Election', up to 25 results sorted by timestamp."}],"resultDescription":"An array of closed position objects, each containing the market title, condition ID, outcome chosen, outcome index, average buy price, current price, total amount bought, realized PnL, end date, proxy wallet address, asset identifiers, and market slugs.","failureModes":["Invalid or malformed wallet address returns a validation error","Using both market and eventId parameters simultaneously returns an error","limit exceeding 50 or offset exceeding 100000 returns a parameter validation error","Wallet address with no closed positions returns an empty array","Unknown conditionId or eventId returns empty results or an error"],"whenToPreferThis":"Use this endpoint when you need historical, resolved prediction market position data for a specific Polymarket wallet — particularly to analyze realized PnL, review trade outcomes, or audit activity on specific markets or events. Prefer this over open-positions endpoints when the user is interested in completed trades rather than live exposure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:30:47.992Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-closed-positions-583c3c48"}