# Cairnworks Verify — Token Holder & Treasury Share Audit

> Cairnworks Verify — Token Holder & Treasury Share Audit is a paid API for AI agents from cairnworks-verify.run402.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-28).

Audits ERC-20 token holder balances and treasury shares at a specific block on Base or BSC, returning signed JSON with a SHA-256 evidence digest.

## Facts

- Endpoint: POST https://cairnworks-verify.run402.com/holder-audit?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cairnworks-verify-token-holder-treasury-share-audit-26ca73e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DQN80fqaqkwf2u53UoKQb

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 cairnworks-verify-token-holder-treasury-share-audit-26ca73e1 -d '<json body>'
```

Example prompt: Can you audit the holder balances and treasury share for FLAPJAX token (0x90c8...) on BSC at the latest block, checking these three wallets: 0x7C34..., 0xABCD..., 0x1234...? I need signed proof of the results.

## When to prefer this

Choose this endpoint when you need cryptographically signed, auditable proof of ERC-20 token holder balances and share percentages at a specific block on Base or BSC — especially for pre-distribution snapshots, treasury audits, or verifying payout recipient holdings. It requires no API key or account, costs a flat $0.02 USDC per call via x402, and returns tamper-evident evidence digests. Prefer it over general blockchain RPC calls when you need structured, human-readable output with built-in auditability.

## Known failure modes

- Invalid token contract address (not ERC-20 or non-existent) returns error
- Block number not yet finalized or out of range
- More than 20 holder addresses submitted (maxItems exceeded)
- Unsupported chain value (only base, bsc, base-sepolia accepted)
- Payment failure via x402 protocol results in 402 response with no data
- Malformed wallet address (non-hex or wrong length) rejected by pattern validation

## How this service works

cairnworks verify — fixed-price x402 (USDC on Base) checks for agent payouts: verify a Base/BSC transaction receipt and ERC-20 transfers (0.01), audit a URL's status/redirects/paywall flags (0.01), token holder and treasury share audit at a block (0.02), batch-verify up to 10 payout receipts (0.02). No account, no API key; every response is signed JSON with a sha256 evidence digest. Free sample outputs at /samples (no payment).

## Output

Returns a signed JSON object containing: token metadata (symbol, address, decimals, total supply), per-holder breakdown (address, balance in human-readable form, percentage share, account type EOA/contract, code size), the resolved block hash and number, chain ID, a list of measured vs unmeasured addresses, and a SHA-256 evidence digest for auditability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "block": {
   "type": [
    "integer",
    "string"
   ],
   "description": "block number or \"latest\""
  },
  "chain": {
   "enum": [
    "bsc",
    "base",
    "base-sepolia"
   ],
   "type": "string"
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  },
  "holders": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[0-9a-fA-F]{40}$"
   },
   "maxItems": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "holder_audit",
  "block": {
   "hash": "0x…",
   "resolved": 128409663,
   "requested": "latest"
  },
  "chain": "bsc",
  "token": {
   "symbol": "FLAPJAX",
   "address": "0x90c8…",
   "decimals": 18,
   "total_supply_human": "44444444444"
  },
  "holders": [
   {
    "address": "0x7C34…",
    "share_pct": 0,
    "account_type": "eoa",
    "balance_human": "…",
    "code_size_bytes": 0
   }
  ],
  "chain_id": 56,
  "measured": [
   "…"
  ],
  "unmeasured": [
   "…"
  ],
  "evidence_sha256": "…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cairnworks-verify-token-holder-treasury-share-audit-26ca73e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cairnworks-verify.run402.com](https://www.zero.xyz/host/cairnworks-verify.run402.com/llms.txt)