{"uid":"cap_DQN80fqaqkwf2u53UoKQb","slug":"cairnworks-verify-token-holder-treasury-share-audit-26ca73e1","name":"Cairnworks Verify — Token Holder & Treasury Share Audit","description":"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).","url":"https://cairnworks-verify.run402.com/holder-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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":"…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FDv7TG6o3U8RWLwvZenj6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-distribution snapshot audit","prompt":"Before we do the airdrop, can you audit how much of the FLAPJAX token (0x90c8...) each of these 5 treasury wallets holds on BSC at block 128409663? I need the balance percentages and a signed evidence digest I can share with the team."},{"title":"Token concentration check for DeFi listing","prompt":"We're reviewing a Base project token at address 0xABCD... — can you pull the holder shares for these 10 wallet addresses at the latest block on Base and tell me if any single wallet controls more than 20% of supply?"},{"title":"Verify payout recipient holdings on BSC","prompt":"After our last payout round, I need to confirm the recipient wallets still hold their claimed token balances — can you audit these 8 addresses against the BSC USDT contract at block 128000000 and give me a verifiable JSON receipt?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:30:53.511Z","isFirstParty":false,"canonicalSlug":"cairnworks-verify-token-holder-treasury-share-audit-26ca73e1"}