# TraceFast Token Holders

> TraceFast Token Holders is a paid API for AI agents from mpp.tracefast.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns the top holders of an Ethereum ERC-20 token contract by balance in descending order, including holder count, using live on-chain data.

## Facts

- Endpoint: GET https://mpp.tracefast.xyz/api/v1/chains/1/tokens/:token/holders
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tracefast-token-holders-506c0e5f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZKQxTpu5piVGiqCwWYA_f

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 tracefast-token-holders-506c0e5f
```

Example prompt: Give me the top 25 holders of the USDC token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, with their balances and total holder count.

## When to prefer this

Use this endpoint when you need live, ranked token holder data for any ERC-20 on Ethereum mainnet — especially for whale analysis, concentration checks, or governance research. Prefer this over block explorer scraping when you need programmatic access, structured JSON output, and a precise holderCount. Best for agents that need top-N holder snapshots without running their own indexer.

## Known failure modes

- Invalid or malformed contract address (not 0x-prefixed or not 40 hex chars) returns an error
- Contract address exists but is not a token contract may return empty or error
- Limit parameter outside 1–100 range may return validation error
- Token with no holders or very new contract may return empty list
- Network or payment failure (x402 micropayment not completed) blocks the response
- Rate limiting or quota exceeded may return 429

## How this service works

TraceFast live Ethereum data: the largest current holders of a token contract. Up to 100 holders in descending balance order, balance in the token's smallest unit, plus holderCount — how many addresses hold a positive balance now. Path token: contract address, 0x-prefixed, 40 hex. Query limit: integer 1..100, default 100. Docs: https://docs.tracefast.xyz/api/token-holders.md

## Output

An ordered list of up to 100 holder objects, each containing the wallet address and token balance in the token's smallest unit (e.g. wei-equivalent), plus a holderCount field indicating the total number of addresses currently holding a positive balance of the token.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tracefast-token-holders-506c0e5f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.tracefast.xyz](https://www.zero.xyz/host/mpp.tracefast.xyz/llms.txt)