{"uid":"cap_KeUMi3cgCQTmu7ZK3F5Uo","slug":"blockrun-ai-560db4d2","name":"BlockRun.AI Polymarket Wallet Positions","description":"Returns a Polymarket wallet's current and historical position data, including market metadata, shares, cost basis, current value, PnL, summary totals, and pagination for additional positions.","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/positions/0x9174e9bFF176285E9B77022eC2e4007904495280","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":{"type":"object","required":["_truncated","_originalSize"],"properties":{"_truncated":{"type":"boolean"},"_originalSize":{"type":"number"}}},"example":{"request":{"input":{"body":{}}},"response":{"_truncated":true,"_originalSize":12100}},"exampleRequest":{"input":{"body":{}}},"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wj6nfQ1qgBBphPvcwivji","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current and historical position data for a specific Polymarket wallet, including market metadata, shares, cost basis, current value, PnL, and pagination.","exampleAgentPrompt":"What are the current Polymarket positions, cost basis, and PnL for wallet 0x9174e9bFF176285E9B77022eC2e4007904495280?","exampleUseCases":null,"resultDescription":"A structured JSON object containing the wallet's open and historical Polymarket positions, each with market metadata (title, category, etc.), number of shares held, cost basis, current market value, realized and unrealized PnL, summary totals across all positions, and pagination info for fetching additional positions.","failureModes":["Invalid or malformed wallet address returns 400 or empty result","Wallet with no Polymarket activity returns empty positions array","Rate limiting or payment failure returns 402 Payment Required","Downstream Polymarket data unavailability causes 503 or stale data","Very large position history may require multiple paginated requests"],"whenToPreferThis":"Use this endpoint when you need detailed portfolio-level analysis of a specific Polymarket wallet, including cost basis tracking, PnL breakdown, and market-level position metadata. Prefer this over generic blockchain explorers when you specifically need Polymarket prediction market context, enriched with market titles and financial summaries rather than raw on-chain transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:29.662Z","isFirstParty":false}