# AgentTools NFT Holder Distribution

> AgentTools NFT Holder Distribution is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns top holders of any NFT collection with ownership quantities, individual/cumulative percentages, and concentration statistics for a given contract address on Ethereum or Base.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/nft/holder-distribution?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-nft-holder-distribution-aea8cba1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EeNCgnTRByFyprZRe3sJ8

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 agenttools-nft-holder-distribution-aea8cba1
```

Example prompt: Who are the top 20 holders of the Bored Ape Yacht Club NFT collection on Ethereum — I want to see how concentrated ownership is, with each wallet's quantity and percentage of supply.

## When to prefer this

Use this endpoint when an agent needs on-chain NFT ownership distribution data — specifically top holders, their quantities, and concentration metrics — for a collection on Ethereum or Base. Prefer this over generic blockchain explorers when you need structured, ready-to-use holder statistics without parsing raw RPC data. Ideal for pre-investment due diligence, rug-pull risk assessment, or any workflow that requires understanding how concentrated or distributed an NFT collection's ownership is.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Unsupported chain (not ethereum or base) returns a validation error
- Contract address belongs to an ERC-20 token rather than an NFT collection, yielding irrelevant or empty data
- Very new collections with few holders may return limited data
- Rate limiting or payment failure returns a 402 or 429 error
- Network timeouts for contracts with extremely large holder counts

## How this service works

Top holders of any NFT collection with exact quantities, individual and cumulative ownership percentages, and concentration statistics — the distribution picture agents need before valuing or recommending a collection. Use this when an agent needs to who owns the collection, and how concentrated is it.

## Output

Returns a ranked list of top NFT holders including each wallet address, the number of NFTs held, individual ownership percentage, cumulative ownership percentage, and overall concentration statistics (e.g. how much of the supply the top N holders control together).

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "contract"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base"
       ],
       "type": "string",
       "description": "Chain"
      },
      "limit": {
       "type": "number",
       "description": "Holders to show"
      },
      "contract": {
       "type": "string",
       "description": "Collection contract"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttools-nft-holder-distribution-aea8cba1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)