# Polymarket Wallet Positions API

> Polymarket Wallet Positions API is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns current open Polymarket prediction market positions for a given proxy wallet address, including market details, outcome, size, average price, current value, and unrealized PnL.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-wallet-positions
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-wallet-positions-api-223f1bad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-nL_3J7y64mfYS0cRrZxp

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 polymarket-wallet-positions-api-223f1bad -d '<json body>'
```

Example prompt: What are the current open Polymarket positions for the proxy wallet address 0xABC123...? I want to see each market, my outcome, position size, average entry price, current value, and unrealized PnL.

## When to prefer this

Use this endpoint when you need real-time open position data for a specific Polymarket wallet, including unrealized PnL and current market value. Prefer this over general blockchain explorers when you specifically need structured Polymarket position data in a ready-to-use format without parsing raw on-chain data yourself.

## Known failure modes

- Invalid or unrecognized proxy wallet address returns empty results or error
- Wallet with no open positions returns an empty array
- Network or upstream Polymarket API outage causes timeout or 5xx error
- Malformed request body (missing required fields) returns 400 bad request
- Payment failure (insufficient USDC balance) blocks the request via x402 protocol

## How this service works

Current open Polymarket positions for a wallet: market, outcome, size, average price, current value and unrealized PnL. Free Polymarket Data API. Pass a proxy wallet address.

## Output

A list of currently open Polymarket positions for the specified wallet, each containing: the prediction market name, the chosen outcome, position size, average purchase price, current market value of the position, and unrealized profit or loss (PnL).

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-wallet-positions-api-223f1bad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)