# pump.x4o2.com Coin Holders (Top Positions)

> pump.x4o2.com Coin Holders (Top Positions) is a paid API for AI agents from pump.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Returns the largest holder positions for a pump.fun token, including wallet, username, amount held, value, cost basis, realized/unrealized P&L, and developer flag.

## Facts

- Endpoint: GET https://pump.x4o2.com/v1/coin/:mint/holders?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pump-x4o2-com-coin-holders-top-positions-c6086cd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nPZVWMtoNraYB-If06md-

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 pump-x4o2-com-coin-holders-top-positions-c6086cd0
```

Example prompt: Show me the top 20 holders of pump.fun token mint 6xK...abc9 — I want to see their wallets, usernames, position values, cost basis, and whether any of them are the developer.

## When to prefer this

Use this endpoint when you need holder-level detail for a specific pump.fun token — particularly for whale concentration analysis, developer wallet monitoring, or evaluating smart-money P&L on a coin. Prefer this over generic Solana holder APIs when you need pump.fun-specific metadata like usernames, profiles, and cost basis that only pump.fun's indexer tracks.

## Known failure modes

- Invalid or non-existent mint address returns an error or empty result
- Token not indexed on pump.fun (e.g. migrated to Raydium) may return stale or incomplete data
- Limit parameter out of range (not 1-100) may be rejected
- Cached response returned when stale=1 may not reflect most recent on-chain state
- Network or upstream pump.fun API outage causes request failure

## How this service works

The largest positions in a coin as pump.fun tracks them: each holder's wallet, pump.fun username and profile, amount held, position value, cost basis, realized and unrealized P&L and whether they are the developer. Use for holder concentration and smart-money analysis of a token.

## Output

An ordered list of the largest token holders, each containing the holder's wallet address, pump.fun username and profile link, number of tokens held, current position value in USD, cost basis, realized P&L, unrealized P&L, and a boolean flag indicating whether the wallet belongs to the token's developer.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "description": "Token mint address (base58)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Number of entries, 1-100"
      },
      "stale": {
       "type": "string",
       "description": "1 returns any cached copy immediately and refreshes in the background"
      },
      "maxAge": {
       "type": "string",
       "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"
      }
     }
    }
   },
   "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/pump-x4o2-com-coin-holders-top-positions-c6086cd0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pump.x4o2.com](https://www.zero.xyz/host/pump.x4o2.com/llms.txt)