# FiatDock ERC-20 Token Holder Analytics

> FiatDock ERC-20 Token Holder Analytics is a paid API for AI agents from fiatdock.com, paid per call via x402, $0.0027/call, status unknown (last checked 2026-10-10).

Returns top-10 holders, LP holders, lock/burn status, concentration metrics, holder count, and creator/owner share for any ERC-20 token across 7 chains

## Facts

- Endpoint: GET https://fiatdock.com/v1/token/holders?utm_source=zero.xyz
- Price: $0.0027/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fiatdock-erc-20-token-holder-analytics-7dc7fc9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lDtuW7uA7jXdbvu-mLv4I

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 fiatdock-erc-20-token-holder-analytics-7dc7fc9f
```

Example prompt: Who are the top 10 holders of the token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum, and are any of them burn or locked addresses? Also tell me how much of the LP is locked.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-dimensional snapshot of ERC-20 token holder distribution in a single call — especially when you need LP lock status, burn/contract address classification, and concentration metrics together. It is particularly useful for due diligence on new or unknown tokens across Base, Ethereum, Polygon, Arbitrum, Optimism, BSC, and Avalanche. Prefer it over generic blockchain explorers when you need structured, agent-ready JSON output with concentration analysis already computed.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty holder list
- Unsupported chain value returns a validation error
- Token with very few holders or brand-new deployment may return incomplete data
- Payment failure via x402 results in 402 response before data is returned
- Rate limiting or upstream node errors may cause transient failures

## How this service works

Who holds an ERC-20: the top 10 holders with their share of supply and whether each is a contract, locked or a burn address, the LP holders and how much LP is locked, the creator's and owner's share, holder count, and concentration with burned/locked supply excluded. Base, Ethereum and five more chains. Send {} for USDC on Base. Pay-per-call via x402. An empty body is answered for USDC on Base (the x402 settlement asset); send {"token":"0x…"} for any other token.

## Output

Returns a structured object containing: top 10 holder wallet addresses with their percentage share of total supply and flags indicating whether each is a smart contract, locked, or burn address; LP holder list with locked LP amounts; creator and owner wallet shares; total unique holder count; and a supply concentration metric calculated excluding burned and locked tokens.

## 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": [],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "optimism",
        "bsc",
        "avalanche"
       ],
       "type": "string",
       "example": "base",
       "description": "Chain, default base"
      },
      "token": {
       "type": "string",
       "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "maxLength": 42,
       "description": "ERC-20 contract address (0x…). Omit the whole body to get USDC on Base"
      }
     }
    }
   },
   "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/fiatdock-erc-20-token-holder-analytics-7dc7fc9f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fiatdock.com](https://www.zero.xyz/host/fiatdock.com/llms.txt)