# BRAINIAC Token Holder Due Diligence

> BRAINIAC Token Holder Due Diligence is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.1/call, status unknown (last checked 2026-11-15).

Analyzes ERC-20 token holder distribution on Base blockchain, returning top holder balances, holder count, supply statistics, and transfer history for a given token and block range.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/token-due-diligence/holders?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-token-holder-due-diligence-c887d90a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qfm71OAiIHyAjPZbK_JKI

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 brainiac-token-holder-due-diligence-c887d90a -d '<json body>'
```

Example prompt: Can you pull the holder distribution for the USDC token at address 0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913 on Base, scanning from block 18000000 to 18001000, and tell me what percentage the top 10 and top 20 wallets control?

## When to prefer this

Use this endpoint when you need on-chain, trustless holder distribution data for any ERC-20 token on Base — especially for due diligence, investment screening, or compliance checks. Prefer it over off-chain analytics dashboards when you need programmatic access to raw holder stats within a specific block range, or when verifying supply concentration directly from the chain.

## Known failure modes

- Invalid or malformed token address returns a validation error
- Block range exceeding 10,000 blocks may be rejected or truncated
- Missing deploymentBlock results in partial holder history that may not reflect complete distribution
- Token address not deployed on Base returns empty or error response
- RPC node unavailability causes timeout or upstream error

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with top 10 and top 20 holder addresses and balances, total holder count, top10 and top20 percentage of supply, total supply, burn holdings, zero mint count, total transfers, a supply match boolean, the scanned block range, current block, data sources (Base JSON-RPC), retrieval timestamp, and any data limitations (e.g. block range capped at 10,000 blocks).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "toBlock": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  },
  "fromBlock": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  },
  "tokenAddress": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$"
  },
  "deploymentBlock": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "partial",
  "holders": {
   "top10": [
    {
     "address": "0x1234567890123456789012345678901234567890",
     "balance": "100000000000000000000000"
    },
    {
     "address": "0xabcdef1234567890abcdef1234567890abcdef12",
     "balance": "50000000000000000000000"
    }
   ],
   "top20": [
    {
     "address": "0x1234567890123456789012345678901234567890",
     "balance": "100000000000000000000000"
    },
    {
     "address": "0xabcdef1234567890abcdef1234567890abcdef12",
     "balance": "50000000000000000000000"
    }
   ],
   "holderCount": 842,
   "supplyMatch": true,
   "totalSupply": "1000000000000000000000000000",
   "burnHoldings": "0",
   "zeroMintCount": 0,
   "totalTransfers": 1523,
   "top10Percentage": 15,
   "top20Percentage": 22
  },
  "sources": [
   {
    "url": "https://mainnet.base.org",
    "source": "Base JSON-RPC",
    "retrievedAt": "2026-10-29T12:00:00.000Z"
   }
  ],
  "toBlock": 18001000,
  "fromBlock": 18000000,
  "result_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "limitations": [
   "Block range is limited to 10000 blocks.",
   "Supply deployment block for complete holder history.",
   "…"
  ],
  "received_at": "2026-11-12T12:00:00.000Z",
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "currentBlock": 18001000,
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "missing_items": [
   {
    "check": "logs_page_timeout",
    "detail": "A Transfer logs page timed out. Holder counts from completed pages below still stand.",
    "reason": "timeout"
   }
  ],
  "scannedBlockRange": "18000000-18001000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-token-holder-due-diligence-c887d90a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
