# Polymarket Market Top Holders by Condition ID

> Polymarket Market Top Holders by Condition ID 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-16).

Returns the top holders of each outcome token for a Polymarket prediction market, including proxy wallet addresses and position sizes by conditionId.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-market-holders
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-top-holders-by-condition-id-b96343d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_--VNggfxNvw8UBXvohETW

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-market-top-holders-by-condition-id-b96343d4 -d '<json body>'
```

Example prompt: Who are the top holders of each outcome token for the Polymarket market with conditionId 0x1234abcd...? I want to see which proxy wallets have the biggest positions on the YES and NO sides.

## When to prefer this

Use this endpoint when you need on-chain holder data for a specific Polymarket prediction market outcome and have the conditionId. It is ideal for whale-watching, sentiment analysis via large positions, and tracking who is on each side of a market. Prefer this over general Polymarket APIs when you specifically need top-holder rankings with proxy wallet addresses and position sizes per outcome token.

## Known failure modes

- Invalid or unknown conditionId returns empty results or an error
- Network timeout if Polymarket data is temporarily unavailable
- Payment failure if x402 USDC payment is not properly authorized
- Malformed request body returns a validation error
- conditionId for an unresolved or delisted market may return incomplete data

## How this service works

Top holders of each outcome token for a Polymarket market (by conditionId): proxy wallet + position size. See who is on each side. Free Polymarket Data API. conditionId from market detail.

## Output

A list of top holders for each outcome token in the specified Polymarket market, including proxy wallet addresses and the size of their positions, broken down by outcome side (e.g. YES vs NO).

## 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-market-top-holders-by-condition-id-b96343d4/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)