# x4o2 StonkFun Token Holders

> x4o2 StonkFun Token Holders is a paid API for AI agents from stonk.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-31).

Returns the up to 20 largest token account holders for a given Solana SPL token mint address

## Facts

- Endpoint: GET https://stonk.x4o2.com/v1/tokens/:mint/holders?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x4o2-stonkfun-token-holders-e21ad007
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qHkhruCmF0-9In_hc4WO7

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 x4o2-stonkfun-token-holders-e21ad007
```

Example prompt: Who are the top holders of the Solana token with mint address So11111111111111111111111111111111111111112? I want to see the largest token accounts and their balances.

## When to prefer this

Use this endpoint when you need on-chain holder concentration data for a specific Solana SPL token and only need the top 20 largest accounts. Ideal for quick due diligence on token distribution, whale tracking, or insider concentration checks. Note that total holder count is not guaranteed, so if you need full holder census data this endpoint may not suffice. Best suited for DeFi research, meme coin analysis, and token vetting workflows on Solana.

## Known failure modes

- Invalid or non-existent mint address returns an error or empty result
- Total wallet holder count may be null if not fully indexed
- Coverage may be partial — only top 20 accounts returned, not all holders
- Data freshness may vary; ageMs in meta indicates staleness
- Network or upstream Solana RPC issues may delay or fail responses

## How this service works

Owners of up to 20 largest token accounts; total wallet count unknown

## Output

Returns a JSON object containing up to 20 of the largest token accounts for the specified mint, including wallet addresses and balances, the Solana slot at which data was observed, an observedAt timestamp, a holderCount field (may be null if total is unknown), and a coverage object indicating whether the result is partial, how many largest accounts were observed, and a human-readable description of coverage limitations.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "description": "Exact Solana token mint"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "data": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "mint": {
         "type": [
          "string",
          "null"
         ]
        },
        "slot": {
         "type": [
          "number",
          "null"
         ]
        },
        "items": {
         "type": [
          "array",
          "null"
         ],
         "items": {
          "type": [
           "object",
           "null"
          ]
         }
        },
        "coverage": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "partial": {
           "type": [
            "boolean",
            "null"
           ]
          },
          "description": {
           "type": [
            "string",
            "null"
           ]
          },
          "totalWalletHolders": {},
          "largestTokenAccounts": {
           "type": [
            "number",
            "null"
           ]
          }
         }
        },
        "observedAt": {
         "type": [
          "string",
          "null"
         ]
        },
        "holderCount": {}
       }
      },
      "meta": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "ageMs": {
         "type": [
          "number",
          "null"
         ]
        },
        "source": {
         "type": [
          "string",
          "null"
         ]
        },
        "partial": {
         "type": [
          "boolean",
          "null"
         ]
        },
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-stonkfun-token-holders-e21ad007/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stonk.x4o2.com](https://www.zero.xyz/host/stonk.x4o2.com/llms.txt)