# Vextorium Polymarket Whale Holders

> Vextorium Polymarket Whale Holders 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-13).

Returns the largest holders (by wallet and share count) for each outcome of a Polymarket prediction market, identified by its slug, plus the aggregate sum of top holder positions.

## Facts

- Endpoint: POST https://api.vextorium.com/polymarket-holders-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-polymarket-whale-holders-736b8d78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jtjzzMOklx8O-BZBSwsKF

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-whale-holders-736b8d78 -d '<json body>'
```

Example prompt: Show me the top 10 whale holders for each outcome of the Polymarket market with slug 'will-trump-win-the-2024-election' so I can see where the big money is betting.

## When to prefer this

Use this endpoint when you need on-chain holder data for Polymarket prediction markets — specifically to identify whale wallets and their concentration per outcome. Prefer this over generic market APIs when you need per-wallet share breakdowns rather than just price or volume data, or when analyzing smart money positioning and market manipulation risk on Polymarket.

## Known failure modes

- Invalid or non-existent slug returns null or empty results
- Limit value outside 1-20 range may cause validation error
- Polymarket data unavailability may result in empty resultados array
- Network timeout if on-chain data is slow to fetch
- Malformed request body returns an error

## How this service works

Largest holders of each outcome of a Polymarket market (by slug): wallet and shares, with the sum of the top holders. See where the whales are betting.

## Output

Returns a JSON object containing the market slug, source, the market question, and an array of outcomes. Each outcome includes its label, an array of the top holder objects (wallet address and share count), and the sum of shares held by those top holders.

## 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": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string"
      },
      "limite": {
       "type": "integer",
       "description": "1-20"
      }
     }
    },
    "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": {
      "slug": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "pregunta": {
       "type": [
        "string",
        "null"
       ]
      },
      "resultados": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "mayores": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "object"
           ],
           "properties": {
            "cartera": {
             "type": [
              "null",
              "string"
             ]
            },
            "participaciones": {
             "type": [
              "null",
              "number"
             ]
            }
           }
          }
         },
         "resultado": {
          "type": [
           "null",
           "string"
          ]
         },
         "suma_participaciones": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-polymarket-whale-holders-736b8d78/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)