# Whale Holders for Token

> Whale Holders for Token is a paid API for AI agents from mpp.hyreagent.fun, $0.03/call, status unknown (last checked 2026-09-14).

Returns the list of whale (large) holders for a given blockchain token address, useful for identifying major stakeholders and concentration risk.

## Facts

- Endpoint: POST https://mpp.hyreagent.fun/base/traders/token/0x4c433f4ef87fE506A7eED2fD1d822CBED411eBA3/whales
- Price: $0.03/call
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mpp-hyreagent-fun-3b5fd987
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1OYaKDcItTTdM9yOeZmLE

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 mpp-hyreagent-fun-3b5fd987 -d '<json body>'
```

Example prompt: Who are the whale holders for token 0x4c433f4ef87fE506A7eED2fD1d822CBED411eBA3 on Base? I want to see which wallets hold the largest amounts and how concentrated the supply is.

## When to prefer this

Use this endpoint when you need to quickly identify large wallet holders ('whales') for a specific token contract address on the Base network. Prefer this over general holder endpoints when you specifically want high-concentration, large-volume holders rather than a full holder list. Ideal for DeFi risk analysis, rug-pull detection, and supply concentration research.

## Known failure modes

- Invalid or non-existent token address returns an error or empty result
- Token address belongs to a different chain than expected (e.g. Solana vs Base)
- Payment of $0.03 USDC not received or x402 payment protocol failure
- Rate limiting or timeout if queried too frequently
- Token with no significant whale holders returns empty list

## How this service works

Whale holders for token

## Output

A list of whale wallet addresses holding the specified token, including their holdings amounts and likely a concentration/ranking breakdown showing which wallets dominate the token supply.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mpp-hyreagent-fun-3b5fd987/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.hyreagent.fun](https://www.zero.xyz/host/mpp.hyreagent.fun/llms.txt)
