# Polymarket User Position Value

> Polymarket User Position Value is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.012/call, status unknown (last checked 2026-10-18).

Returns the total USDC value of a user's open positions on Polymarket, optionally filtered by specific markets.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/value?utm_source=zero.xyz
- Price: $0.012/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-user-position-value-c68477bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jz8vjK_EktPADu0Or3WlI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-polymarket-user-position-value-c68477bc
```

Example prompt: What's the total value of all Polymarket positions held by wallet 0x56687bf447db6ffa42ffe2204a05edaa20f55839?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Returns the total value of a user's positions.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-user-position-value-c68477bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)
