# AgentFeed Token Holders

> AgentFeed Token Holders is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Returns top token holders for a Solana SPL token mint, including concentration metrics, top account addresses, percentages, and amounts.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/token-holders/%7Bmint%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-token-holders-52000faf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7ieRUWIiTL0s7CKX2GqQS

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 agentfeed-token-holders-52000faf
```

Example prompt: Who are the top holders of the Bonk token on Solana — give me the biggest wallet addresses, their percentages of supply, and how concentrated ownership is overall? The mint address is DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263.

## When to prefer this

Use this endpoint when you need on-chain Solana token holder distribution data without setting up API keys or accounts. It is ideal for quick whale concentration analysis, rug-pull screening, or due-diligence checks on SPL tokens. Prefer it over general blockchain explorers when you need structured, machine-readable holder data for AI agent workflows. Not suitable for extremely high-holder-count tokens like USDC.

## Known failure modes

- Fails for tokens with extremely large numbers of holders (USDC-scale) due to data volume limits
- Mint address not found or invalid returns an error
- Top accounts include DEX pools and exchange wallets which may distort concentration metrics
- Payment not processed via x402 results in 402 response requiring USDC payment on Solana or Base

## How this service works

Live crypto market, liquidation, tokenized-equity and Solana on-chain data for AI agents. Paid per call in USDC over x402 on Solana or Base. No API keys, no accounts.

## Output

Returns a JSON object with the token symbol, total supply, a ranked list of top holder accounts (each with address, amount held, and percentage of supply), and concentration summary metrics showing what percentage the top 1, top 5, and top 10 holders control. Includes a note that accounts include exchange and pool addresses, not just unique individual owners, and that the endpoint may fail for mega-holder tokens like USDC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
   "note": "token accounts, not unique owners — pools and exchanges included. Fails for mega-holder tokens (USDC-scale).",
   "supply": 87994383847609.11,
   "symbol": "Bonk",
   "top_accounts": [
    {
     "pct": 8.83,
     "amount": 7770515063166.431,
     "address": "5hpfC9VBxVcoW9opCnM2PqR6YWRLBzrBpabJTZnwwNiw"
    },
    {
     "pct": 6.56,
     "amount": 5772593511837.953,
     "address": "2vPvEovB1gw8bAUqasThEv6YMAdJ77AU3RxiUNqknEiw"
    },
    {
     "pct": 3.54,
     "amount": 3111312968005.839,
     "address": "6LozHQrLbEPeJGWKpN6wnnk76GhD4bGAVSoTBE5xXpsf"
    }
   ],
   "concentration": {
    "top1_pct": 8.83,
    "top5_pct": 25.02,
    "top10_pct": 38.33
   }
  },
  "paid": true,
  "tool": "get_token_holders"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-token-holders-52000faf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)