{"uid":"cap_jz8vjK_EktPADu0Or3WlI","slug":"aisa-mpp-data-apis-polymarket-user-position-value-c68477bc","name":"Polymarket User Position Value","description":"Returns the total value of a user's positions.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/value?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["user"],"properties":{"user":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User Profile Address (0x-prefixed, 40 hex chars)"},"market":{"type":"array","items":{"type":"string","example":"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917","pattern":"^0x[a-fA-F0-9]{64}$","description":"0x-prefixed 64-hex string"}}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User Profile Address (0x-prefixed, 40 hex chars)"},"value":{"type":"number"}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5DRRgYmG7Ue8kNt0oRXWv","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Returns the total USDC value of a user's open positions on Polymarket, optionally filtered by specific markets.","exampleAgentPrompt":"What's the total value of all Polymarket positions held by wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839?","exampleUseCases":[{"title":"Prediction market portfolio check","prompt":"Can you tell me the current total value of my Polymarket positions for wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839?"},{"title":"Exposure in a specific market","prompt":"How much are the positions of wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839 worth in the Polymarket market 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917?"},{"title":"Track whale portfolio value","prompt":"Look up the total Polymarket position value for address 0xAbCd1234567890abcd1234567890abcd12345678 — I want to track how much this wallet has at stake."}],"resultDescription":"An array of objects, each containing the user's wallet address and the total numeric value (in USDC) of their positions. If a market filter is applied, the value reflects positions only within those specified markets.","failureModes":["Invalid or malformed user address (not matching ^0x[a-fA-F0-9]{40}$) returns an error","Invalid market address format returns an error","User address with no positions may return an empty array or zero value","Rate limiting or upstream Polymarket API unavailability may cause failures"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve the current USDC value of a specific Ethereum wallet's open positions on Polymarket, optionally scoped to one or more specific prediction market contracts. Prefer this over manual Polymarket UI checks when building automated portfolio trackers, whale watchers, or risk dashboards for prediction market participants.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:58.495Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-user-position-value-c68477bc"}