{"uid":"cap_rU_6-qUWcfSNT5xJBjlns","slug":"polymarket-wallet-positions-7ef2a205","name":"Polymarket Wallet Positions","description":"A Polymarket wallet's open positions (market, outcome, shares, average price, value, PnL) and latest trades with portfolio totals. Use to follow or vet a trader.","url":"https://bess-x402.onrender.com/v1/predictions/polymarket/wallet?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer","description":"Rows (1-50)"},"address":{"type":"string","description":"Polymarket proxy wallet (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PINHWDxQPWTEjEBdMN2CZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns open positions, latest trades, and portfolio totals for a given Polymarket proxy wallet address.","exampleAgentPrompt":"Can you pull up the open positions and recent trades for the Polymarket wallet 0x1234abcd...? Show me up to 20 rows so I can see how they've been performing.","exampleUseCases":[{"title":"Vetting a trader before copying","prompt":"Before I follow this Polymarket trader, can you show me their open positions and PnL for wallet 0xabc123...? I want to see up to 30 rows to get a full picture of their strategy."},{"title":"Monitoring personal prediction market portfolio","prompt":"What are my current open Polymarket positions and how am I doing overall? My proxy wallet is 0xdef456... — show me all my positions with the latest value and profit/loss."},{"title":"Researching a whale's market bets","prompt":"I heard this Polymarket whale at 0x789ghi... is heavily positioned on the election markets — can you look up their wallet and show me their top 50 open positions and recent trades?"}],"resultDescription":"Returns a list of open positions (market name, outcome, shares held, average entry price, current value, unrealized PnL) and a log of latest trades, plus aggregate portfolio totals such as total value and total PnL.","failureModes":["Invalid or non-proxy wallet address returns empty results or an error","Address with no Polymarket activity returns empty positions list","Limit parameter out of range (must be 1-50) causes a validation error","Polymarket API unavailability causes upstream timeout or 5xx response","Checksum-invalid EVM address may be rejected"],"whenToPreferThis":"Use this endpoint when you need on-chain Polymarket portfolio data — open positions, trade history, and PnL — for a specific wallet address, especially for vetting or following a trader. Prefer this over generic blockchain explorers when you need Polymarket-specific enrichment like market names, outcomes, and computed PnL rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:39:36.204Z","isFirstParty":false,"canonicalSlug":"polymarket-wallet-positions-7ef2a205"}