{"uid":"cap_gM8mRjBlUtkbAcaj6fB0t","slug":"polymarket-wallet-portfolio-value-3448fb3b","name":"Polymarket Wallet Portfolio Value","description":"Total current portfolio value (USDC) of all open Polymarket positions for a wallet address. Free Polymarket Data API. Pass a proxy wallet address.","url":"https://proxy.suverse.io/v1/data/polymarket-wallet-value","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NM-4kLyF2wnPY4tLb3vmh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total current portfolio value in USDC of all open Polymarket prediction market positions for a given proxy wallet address.","exampleAgentPrompt":"What's the total USDC value of all my open Polymarket positions right now? My proxy wallet address is 0xAbC123...","exampleUseCases":[{"title":"Monitor personal Polymarket portfolio value","prompt":"Can you check how much my Polymarket positions are currently worth in USDC? My proxy wallet is 0x1a2b3c4d5e6f..."},{"title":"Track a trader's prediction market exposure","prompt":"I want to know the total USDC value of all open Polymarket positions for this wallet address: 0xDEAD...BEEF — can you look that up for me?"},{"title":"Automated portfolio value alert","prompt":"Every hour, check the total USDC value of my Polymarket portfolio at proxy wallet 0xA1B2C3... and let me know if it drops below $500."}],"resultDescription":"Returns a numeric value representing the total current portfolio worth in USDC across all open Polymarket prediction market positions held by the specified proxy wallet address.","failureModes":["Invalid or unrecognized wallet address returns an error or zero value","Wallet with no open positions returns zero or empty result","Network or upstream Polymarket API unavailability causes timeout or 5xx error","Payment of $0.05 USDC via x402 protocol fails, blocking the request","Malformed POST body missing required fields returns 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need a single aggregated USDC valuation of all open Polymarket positions for a specific proxy wallet, without having to parse individual market positions yourself. It is ideal for portfolio dashboards, monitoring agents, or any workflow that needs a quick, ready-to-use total value without complex on-chain data parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:02:02.969Z","isFirstParty":false}