{"uid":"cap_I9ttyEcxH-q0XoeVuMVk8","slug":"polymarket-user-positions-fetch-f2d6a013","name":"Polymarket User Positions Fetch","description":"Fetch all user positions with filtering and pagination","url":"https://sol.blockrun.ai/api/v1/pm/polymarket/positions?utm_source=zero.xyz","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":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0075","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0075","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0075","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Kup0QE_mZyF7SqcD22WHx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0075","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetch all positions held by a user on Polymarket with support for filtering and pagination","exampleAgentPrompt":"Show me all the current Polymarket positions held by wallet address 0xABC123, including any open bets across all markets.","exampleUseCases":[{"title":"Portfolio overview for a trader","prompt":"Pull up all the Polymarket positions for wallet 0xDEF456 so I can see what markets they're currently exposed to and how much they've got in each."},{"title":"Monitoring a smart money wallet","prompt":"Fetch all open Polymarket positions for the address 0x789XYZ — I want to track where this whale is positioned across prediction markets."},{"title":"Auditing resolved vs open positions","prompt":"Get all Polymarket positions for my wallet 0xMYWALLET and filter for the ones that are still open so I can review my active exposure before the week ends."}],"resultDescription":"Returns a paginated list of user positions on Polymarket, including details about each position such as the market, outcome token, size, and relevant metadata. The response wraps position records in a data object with pagination support.","failureModes":["Invalid or missing wallet address returns empty results or error","Unsupported filter parameters may be silently ignored","Pagination cursor out of bounds returns empty page","Rate limiting or payment failure (x402) blocks the request","Wallet with no positions returns an empty data array"],"whenToPreferThis":"Use this endpoint when you need to retrieve a comprehensive list of positions for a specific user on Polymarket specifically, with filtering and pagination support. Prefer this over a broad multi-platform search when you only need Polymarket data for portfolio tracking, position auditing, or monitoring a specific wallet's exposure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:45:15.592Z","isFirstParty":false,"canonicalSlug":"polymarket-user-positions-fetch-f2d6a013"}