{"uid":"cap_twLbcvTkzLTypEDvZFHlI","slug":"blockrun-ai-4f939a1a","name":"BlockRun.AI Polymarket User Positions","description":"Fetch all user positions with filtering and pagination","url":"https://blockrun.ai/api/v1/pm/polymarket/positions","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{}}},"response":{"_truncated":true,"_originalSize":75863}},"exampleRequest":{"input":{"body":{}}},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dIZNe3L4SU--2RL6ycIE5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetch all Polymarket positions for a user with filtering and pagination support","exampleAgentPrompt":"Can you pull up all of my current Polymarket positions for wallet 0xAbC123... and show me what markets I'm in right now?","exampleUseCases":null,"resultDescription":"Returns a paginated list of user positions on Polymarket, including market metadata, share quantities, current values, and position details for each open or historical market the wallet has participated in.","failureModes":["Invalid or missing wallet address returns empty or error response","Pagination parameters out of range return empty data set","Rate limiting or payment failure returns 402 or 429 status","Wallet with no positions returns empty data array","Network or upstream Polymarket API unavailability causes 503"],"whenToPreferThis":"Use this endpoint when you need to enumerate all positions held by a specific Polymarket user, especially when you need pagination support for wallets with many positions. Prefer this over the wallet analytics endpoint when you want raw position data rather than aggregated performance metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:46:39.561Z","isFirstParty":false}