# BlockRun.AI Polymarket Market Top Holders

> BlockRun.AI Polymarket Market Top Holders is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the top holders for a specific Polymarket prediction market, including wallet addresses, position sizes, values, PnL, and trade counts.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/pm/polymarket/market/0x0fb006e0c06caa4db12f7e30ec8c2483d658f83eb57b2ee8eb478e39beca3dfd/top-holders
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-c336c2a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VB4YO8rLckFW_UZBjhirp

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 blockrun-ai-c336c2a0
```

Example prompt: Show me the top holders for Polymarket market 0x0fb006e0c06caa4db12f7e30ec8c2483d658f83eb57b2ee8eb478e39beca3dfd — I want to see the biggest wallets, their position sizes, PnL, and trade counts.

## When to prefer this

Use this endpoint when you need to identify the top position holders in a specific Polymarket prediction market by contract address, want to analyze whale activity or PnL leaders, or are building analytics around market concentration and trader behavior on Polymarket.

## Known failure modes

- Invalid or non-existent market contract address returns empty or error response
- Market with no activity may return empty holder list
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Truncated response for very large holder sets requiring pagination
- Network timeout for slow on-chain data retrieval

## How this service works

Returns the top holders for a specific Polymarket market, including wallet addresses, position sizes, values, PnL, trade counts, and pagination metadata.

## Output

A ranked list of top wallet holders for the specified Polymarket market, including each wallet address, position size in shares, position value in USD, realized and unrealized PnL, total trade count, and pagination metadata for navigating additional results.

## Example request

```json
{
 "input": {
  "body": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "_truncated",
  "_originalSize"
 ],
 "properties": {
  "_truncated": {
   "type": "boolean"
  },
  "_originalSize": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-c336c2a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)