# httpay.xyz Token Holder Monitor

> httpay.xyz Token Holder Monitor is a paid API for AI agents from httpay.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Tracks the top 10 holders, whale distribution, and concentration (HHI) for any token on a specified chain

## Facts

- Endpoint: POST https://httpay.xyz/api/token-holder-monitor
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/httpay-xyz-token-holder-monitor-4948c364
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l35vDmmjMeAB2uOkztiIS

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 httpay-xyz-token-holder-monitor-4948c364 -d '<json body>'
```

Example prompt: Show me the top 10 holders of USDC on Base and tell me how concentrated the ownership is — I want to know the HHI and whether whales dominate the supply.

## When to prefer this

Use this endpoint when you need a quick snapshot of token holder concentration, whale dominance, and top-holder rankings for a specific token on Base or another supported chain. Prefer this over generic block explorers when you need the HHI concentration metric computed automatically alongside ranked holder data.

## Known failure modes

- Unknown or unsupported token symbol returns an error or empty result
- Unsupported chain identifier returns a validation error
- On-chain data temporarily unavailable causes a timeout or partial result
- Demo mode returns synthetic data not reflecting real holders
- Malformed request (missing token or chain param) returns a 400-level error

## How this service works

Token Holder Monitor — tracks top 10 holders, whale distribution & concentration (HHI) for any token. Params: ?token=USDC&chain=base. Demo: ?demo=true.

## Output

Returns a ranked list of the top 10 token holders with their addresses and balances, whale distribution breakdown, and a Herfindahl-Hirschman Index (HHI) score indicating how concentrated token ownership is.

## Example request

```json
{
 "chain": "base",
 "token": "USDC"
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "description": "Token Holder Monitor — tracks top 10 holders, whale distribution & concentration (HHI) for any token. Params: ?token=USDC&chain=base. Demo: ?demo=true."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/httpay-xyz-token-holder-monitor-4948c364/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from httpay.xyz](https://www.zero.xyz/host/httpay.xyz/llms.txt)