# apexfaucet.xyz Token Holders Lookup

> apexfaucet.xyz Token Holders Lookup is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-02).

Returns the top 20 deduplicated token holders for a given Solana/Arc token mint address.

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/holders/:mint?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apexfaucet-xyz-token-holders-lookup-3d7fafc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r2Y3w1pVaSMoJ-CyXRJhw

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 apexfaucet-xyz-token-holders-lookup-3d7fafc1
```

Example prompt: Who are the top 20 holders of the token with mint address 9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9E? I want a deduplicated list ranked by how much they hold.

## When to prefer this

Choose this endpoint when you need a quick, deduplicated snapshot of the top 20 holders for a specific token on Arc/X1/Solana-compatible chains, especially for whale analysis, concentration checks, or pre-investment due diligence. It is purpose-built for token holder lookups and deduplicates by owner, making it more reliable than raw on-chain queries that may double-count multi-account holders.

## Known failure modes

- Invalid or malformed mint address returns an error or empty result
- Mint address not found on-chain returns no holders
- Network or RPC node issues may cause timeouts or stale data
- Newly created tokens with no holders return an empty list
- Payment failure (insufficient USDC) blocks the request

## How this service works

Top 20 holders for a token, deduped by owner.

## Output

A ranked list of up to 20 token holder wallet addresses, deduplicated by owner, along with their respective token balances or holdings, allowing analysis of ownership concentration and whale distribution for the given mint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "description": "X1 token mint address (base58), e.g. Du6Z596DwGnfUcMSyRHSBQzNybiQKu8GESVfruEv9Jqr (APEX)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

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