{"uid":"cap_UTrlEJQdu0nRN61Zqu4ba","slug":"blockrun-ai-1dffc833","name":"BlockRun.AI Polymarket Wallet Positions","description":"Get open and historical positions for a wallet address","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/positions/:address","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":{"address":"0x1234567890123456789012345678901234567890"}}},"response":{"summary":{"net_fees":0,"win_rate":null,"fees_paid":0,"fees_refunded":0,"total_cost_usd":0,"total_positions":0,"total_value_usd":0,"losing_positions":null,"winning_positions":null,"total_realized_pnl_usd":0,"total_unrealized_pnl_usd":0},"positions":[],"pagination":{"count":0,"limit":100,"has_more":false,"pagination_key":null},"wallet_address":"0x1234567890123456789012345678901234567890"}},"exampleRequest":{"input":{"body":{"address":"0x1234567890123456789012345678901234567890"}}},"tags":["x402"],"displayCostAmount":"0.005000","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.005000/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_0lJpPUwOoIiKaGLZSYF4v","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":"Retrieves open and historical prediction market positions for a given wallet address on Polymarket","exampleAgentPrompt":"What are all the open and historical Polymarket positions for wallet address 0x1234abcd...? I want to see every prediction market they've held shares in.","exampleUseCases":null,"resultDescription":"Returns a data object containing the wallet's open and historical positions on Polymarket, including market details, position sizes, and relevant metadata for each prediction market the wallet has participated in.","failureModes":["Invalid or malformed wallet address returns an error","Wallet address with no Polymarket activity may return empty positions array","Network timeout or upstream Polymarket data unavailability","Rate limiting if too many requests are made in quick succession","Payment failure if x402 USDC payment is not correctly handled"],"whenToPreferThis":"Use this endpoint when you need to look up a specific wallet's Polymarket positions — both currently open and historical — especially within an agent workflow analyzing prediction market portfolios, tracking trader behavior, or auditing on-chain prediction market activity. Prefer this over generic blockchain explorers when you specifically need structured Polymarket position data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:53:15.120Z","isFirstParty":false}