# Animica ANM Token Holders List

> Animica ANM Token Holders List is a paid API for AI agents from animica.dev, paid per call via x402, $0.002161/call, status unknown (last checked 2026-09-13).

Returns a ranked list of ANM token holders with their balances and share percentages as of the latest chain block

## Facts

- Endpoint: POST https://animica.dev/x402/chain/holders
- Price: $0.002161/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/animica-anm-token-holders-list-a1d5eab3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L4Qj70OkRh8Ki6-D39Pmr

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 animica-anm-token-holders-list-a1d5eab3 -d '<json body>'
```

Example prompt: Show me the top 25 ANM token holders on Animica — I want their addresses, balances, and what percentage of the total supply each one holds.

## When to prefer this

Use this endpoint when you need on-chain ANM token holder data directly from the Animica platform, particularly for ownership distribution analysis, whale tracking, or building holder leaderboards. Prefer this over manual chain exploration when you need ranked, paginated holder data with share percentages already computed.

## Known failure modes

- limit out of range (must be 1-1000): returns validation error
- payment failure via x402 protocol: returns 402 Payment Required if USDC not provided
- chain data unavailable: service may return 503 if node is syncing
- empty holders array if chain has no holders yet

## How this service works

A ranked snapshot of ANM holders at a pinned chain height — up to 1000 accounts with exact nANM balances as decimal strings, plus the total address count and the head it was taken at. The shape airdrops, governance weighting and distribution analysis actually need, in one call instead of thousands of balance lookups.

## Output

A JSON object containing: the block height the snapshot was taken at (as_of), total number of unique addresses holding ANM (total_addresses), the count of results returned, an ordered array of holders each with rank, wallet address, balance in nanoANM (balance_nanm), balance in ANM (balance_anm), and percentage share of total supply (share_percent), plus the total observed supply at that block.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "how many holders to return, 1..1000 (default 100)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/animica-anm-token-holders-list-a1d5eab3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from animica.dev](https://www.zero.xyz/host/animica.dev/llms.txt)