# Polymarket Top Holders

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

Returns the top token holders for one or more Polymarket prediction market condition IDs, including wallet info, position amounts, and profile details.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/holders?utm_source=zero.xyz
- Price: $0.00044/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-top-holders-31156518
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qxikRoEXwqPRRPzavQFFY

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-top-holders-31156518
```

Example prompt: Who are the top 10 holders for the Polymarket market with condition ID 0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917? Only show wallets with a balance of at least 50 tokens.

## When to prefer this

Use this endpoint when you need on-chain holder distribution data for specific Polymarket prediction markets — e.g. to identify whale wallets, measure position concentration, or profile large traders. Prefer this over a general leaderboard endpoint when you have specific condition IDs and want per-market holder breakdowns rather than global rankings.

## Known failure modes

- Missing or malformed condition ID (not 0x-prefixed 64 hex chars) returns a validation error
- Requesting more than 20 holders per token is capped at 20
- No holders meeting the minBalance threshold returns an empty holders array
- Invalid market condition ID that doesn't exist on Polymarket may return empty results
- Network or upstream Polymarket API outage may cause timeout or 5xx error

## How this service works

Get top holders for one or more markets.

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

## Output

An array of objects, one per token in the queried markets. Each object contains the token identifier and a list of top holders sorted by position size. Each holder entry includes their proxy wallet address, display name or pseudonym, bio, profile image URLs, token asset, amount held, outcome index, and whether their username is publicly visible.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "market"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 20,
   "minimum": 0,
   "description": "Maximum number of holders to return per token. Capped at 20."
  },
  "market": {
   "type": "array",
   "items": {
    "type": "string",
    "example": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "pattern": "^0x[a-fA-F0-9]{64}$",
    "description": "0x-prefixed 64-hex string"
   },
   "description": "Comma-separated list of condition IDs."
  },
  "minBalance": {
   "type": "integer",
   "default": 1,
   "maximum": 999999,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object",
  "properties": {
   "token": {
    "type": "string"
   },
   "holders": {
    "type": "array",
    "items": {
     "type": "object",
     "properties": {
      "bio": {
       "type": "string"
      },
      "name": {
       "type": "string"
      },
      "asset": {
       "type": "string"
      },
      "amount": {
       "type": "number"
      },
      "pseudonym": {
       "type": "string"
      },
      "proxyWallet": {
       "type": "string",
       "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "User Profile Address (0x-prefixed, 40 hex chars)"
      },
      "outcomeIndex": {
       "type": "integer"
      },
      "profileImage": {
       "type": "string"
      },
      "displayUsernamePublic": {
       "type": "boolean"
      },
      "profileImageOptimized": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-top-holders-31156518/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)