{"uid":"cap_zcnCM-_ZGm-kgSw3AZv79","slug":"aisa-mpp-data-apis-polymarket-market-positions-ca4090ea","name":"Polymarket Market Positions","description":"Returns positions for a market, optionally filtered to a single 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/v1/market-positions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["market"],"properties":{"user":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"Filter to a single user by proxy wallet address"},"limit":{"type":"integer","default":50,"maximum":500,"minimum":0,"description":"Max number of positions to return per outcome token"},"market":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"The condition ID of the market to query positions for"},"offset":{"type":"integer","default":0,"maximum":10000,"minimum":0,"description":"Pagination offset per outcome token"},"sortBy":{"enum":["TOKENS","CASH_PNL","REALIZED_PNL","TOTAL_PNL"],"type":"string","default":"TOTAL_PNL","description":"Sort positions by:\n- `TOKENS` — Position size (number of tokens)\n- `CASH_PNL` — Unrealized cash PnL\n- `REALIZED_PNL` — Realized PnL\n- `TOTAL_PNL` — Total PnL (cash_pnl + realized_pnl)\n"},"status":{"enum":["OPEN","CLOSED","ALL"],"type":"string","default":"ALL","description":"Filter positions by status.\n- `OPEN` — Only positions with size > 0.01\n- `CLOSED` — Only positions with size <= 0.01\n- `ALL` — All positions regardless of size\n"},"sortDirection":{"enum":["ASC","DESC"],"type":"string","default":"DESC"}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string","description":"The outcome token asset ID"},"positions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"size":{"type":"number"},"asset":{"type":"string"},"cashPnl":{"type":"number"},"outcome":{"type":"string"},"avgPrice":{"type":"number"},"totalPnl":{"type":"number"},"verified":{"type":"boolean"},"currPrice":{"type":"number"},"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"},"outcomeIndex":{"type":"integer"},"profileImage":{"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_iBjmikYTy-jYc3g71VCaT","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 all trader positions for a specific Polymarket prediction market, optionally filtered to a single user's wallet address.","exampleAgentPrompt":"Show me the top 20 open positions in the Polymarket market with condition ID 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917, sorted by total PnL descending.","exampleUseCases":[{"title":"Leaderboard for a prediction market","prompt":"Pull the top 50 traders by total PnL in the Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917 — only show open positions."},{"title":"Track a specific wallet's market exposure","prompt":"What positions does wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839 hold in Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917, and what's their realized PnL?"},{"title":"Analyze closed positions after market resolution","prompt":"Get me all closed positions in Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917, sorted by realized PnL from highest to lowest, up to 100 results."}],"resultDescription":"Returns an array of outcome token objects, each containing a token asset ID and a list of position records. Each position record includes the trader's proxy wallet, position size, average buy price, current price, current value, total tokens bought, unrealized cash PnL, realized PnL, total PnL, outcome name, outcome index, verified status, and profile image URL.","failureModes":["Invalid market condition ID format (not a 0x-prefixed 64-hex string) returns a validation error","Invalid user wallet address format (not a 0x-prefixed 40-hex string) returns a validation error","Market condition ID not found returns an empty array or 404","Offset exceeds the 10000 maximum returns a validation error","Limit exceeds 500 maximum returns a validation error","Network or upstream Polymarket API downtime returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need position-level data for a specific Polymarket prediction market — including who holds positions, their size, pricing, and PnL breakdown. Prefer this over order book endpoints when you want aggregated trader exposure rather than individual orders, and over portfolio endpoints when you want all participants in a market rather than a single user's full portfolio.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:50:40.713Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-market-positions-ca4090ea"}