# Vextorium Polymarket Wallet Positions

> Vextorium Polymarket Wallet Positions is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Retrieves all open prediction market positions, PnL, and portfolio summary for a given Polymarket wallet address

## Facts

- Endpoint: POST https://api.vextorium.com/v1/polymarket-wallet?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-polymarket-wallet-positions-24d2a3fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qOoAav7SGMIY10xTTgxSS

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 vextorium-polymarket-wallet-positions-24d2a3fd -d '<json body>'
```

Example prompt: Pull up all the Polymarket positions and PnL for wallet 0x5d189e816b4149be00977c1a3c8840374aec4972 — I want to see what markets they're betting on, their current value, and total profit or loss.

## When to prefer this

Use this endpoint when you need a complete view of a Polymarket wallet's prediction market activity, including open positions, entry prices, current market prices, and realized/unrealized PnL. Prefer this over generic on-chain lookups when the goal is specifically Polymarket portfolio analysis rather than raw token balances or transaction history.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Wallet with no Polymarket activity returns empty positions array
- Polymarket public API downtime causes upstream failure
- Rate limiting if called excessively in short intervals
- Limit parameter ignored or capped at platform maximum

## How this service works

Open positions of a wallet on Polymarket: market, outcome, shares, average and current price, value, PnL (USD and %), redeemable flag and close date, with portfolio totals.

## Output

Returns a full portfolio snapshot for the wallet: list of individual market positions (slug, market question, result side, stakes, average buy price, current price, value in USD, invested USD, PnL in USD and percent), plus aggregate totals (total positions count, total invested USD, total current value USD, total PnL USD), and the data source attribution.

## 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": {
     "required": [
      "wallet"
     ],
     "properties": {
      "limit": {
       "type": "integer"
      },
      "wallet": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "detail": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "slug": {
          "type": [
           "null",
           "string"
          ]
         },
         "close": {
          "type": [
           "null",
           "string"
          ]
         },
         "market": {
          "type": [
           "null",
           "string"
          ]
         },
         "result": {
          "type": [
           "null",
           "string"
          ]
         },
         "stakes": {
          "type": [
           "null",
           "number"
          ]
         },
         "pnl_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "pnl_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "avg_price": {
          "type": [
           "null",
           "number"
          ]
         },
         "value_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "chargeable": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "invested_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "current_price": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "s
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "detail": [
   {
    "slug": "will-mark-cuban-win-the-2028-democratic-presidential-nomination-329",
    "close": "2028-11-08",
    "market": "Will Mark Cuban win the 2028 Democratic presidential nomination?",
    "result": "Yes",
    "stakes": 1715833.79,
    "pnl_pct": -38.89,
    "pnl_usd": -6005.42,
    "avg_price": 0.009,
    "value_usd": 9437.09,
    "chargeable": false,
    "invested_usd": 15442.5,
    "current_price": 0.0055
   },
   {
    "slug": "will-dwayne-the-rock-johnson-win-the-2028-democratic-presidential-nomination",
    "close": "2028-11-08",
    "market": "Will Dwayne 'The Rock' Johnson win the 2028 Democratic presidential nomination?",
    "result": "Yes",
    "stakes": 744429.11,
    "pnl_pct": 6.75,
    "pnl_usd": 541.02,
    "avg_price": 0.0107,
    "value_usd": 8560.93,
    "chargeable": false,
    "invested_usd": 8019.91,
    "current_price": 0.0115
   }
  ],
  "source": "Polymarket (public data API)",
  "wallet": "0x5d189e816b4149be00977c1a3c8840374aec4972",
  "positions": 267,
  "total_pnl_usd": -684338.04,
  "total_value_usd": 85687.7,
  "total_invested_usd": 770025.71
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-polymarket-wallet-positions-24d2a3fd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)