# Arkham x402 Polymarket Top Holders

> Arkham x402 Polymarket Top Holders is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.6/call, status unknown (last checked 2026-09-14).

Returns the top holders for a given Polymarket prediction market condition, with wallet intelligence from Arkham.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/top-holders
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-top-holders-db1cb495
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TuXzsSl0jgX39yNUNGn_U

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 arkham-x402-polymarket-top-holders-db1cb495 -d '<json body>'
```

Example prompt: Who are the top holders for Polymarket condition 0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1? I want to see which wallets are most exposed to that market.

## When to prefer this

Use this endpoint when you need on-chain wallet-level intelligence for a specific Polymarket prediction market, especially when you want to identify whale positions or smart money exposure. Prefer this over generic blockchain explorers when you need ranked, structured holder data enriched with Arkham's wallet identity layer.

## Known failure modes

- Invalid or unknown conditionId returns empty holders array
- Malformed conditionId format causes request error
- Insufficient USDC balance for x402 pay-per-request fails the call
- Rate limiting or quota exceeded returns an error
- Market condition not indexed by Arkham returns no data

## How this service works

Get Arkham Polymarket top holders. $0.60 per call.

## Output

A JSON object containing a list of top holder wallet addresses and their positions for the specified Polymarket conditionId, along with the conditionId itself for reference.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max entries to return (1-100). Default: 20."
  },
  "outcome": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional. 0 for Yes token, 1 for No token. Omit for all tokens."
  },
  "conditionId": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Required. Polymarket condition ID for the market."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "holders": [],
  "conditionId": "0x9be56371f6a29d12769b2f196847ee825b9585ebb8bfa042136be031b081eba1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-top-holders-db1cb495/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)