# holder-check

> Holder Analysis API for Base tokens: top 10 holders with % and type (wallet, contract, LP pool, burn) plus known labels (87 Base exchanges, lockers, bridges, DEX contracts, each with source), concentration excluding labeled exchange/bridge/locker holders, distribution verdict and bundling check from real on-chain data. $0.02 per call via x402 (USDC on Base). Not investment advice.

- Base URL: https://holder-check.restockalarm.workers.dev
- Pay per call via x402: USDC on Base (eip155:8453) or Polygon PoS (eip155:137), payTo 0x7B97303d62517eA9E26D1E1b199Eac42a487F430
- Free demo: 5 calls/day per IP under /demo/...
- Card alternative: X-API-Key header, 4 credits per call. Credit packs (all APIs): 250 calls $1.25 https://space-command-kits-shop.fourthwall.com/products/api-credits-250-calls | 1000 calls $5 https://space-command-kits-shop.fourthwall.com/products/api-credits-1000-calls | 5000 calls $15 https://space-command-kits-shop.fourthwall.com/products/api-credits-5000-calls; claim key https://api-keys.restockalarm.workers.dev/claim
- No address: GET without address answers for the AERO example (0x940181a94A35A4569E4529A3CDfB74e38FD98631) with example=true and a note; an invalid address is still 400
- Errors: 400 bad input, 404 no contract, 422 no data, 503 + Retry-After = a core field could not be measured right now (not charged: x402 not settled, API-key credits refunded)
- Core fields: holder type (wallet/contract/lp/burn) for every top-10 holder and distribution (never 'ukendt' in a 200). If they cannot be measured right now: 503 + Retry-After, not charged. If only the ~2 h transfer history (same_block_check) is missing, the answer is 200 with temporarily_unavailable and cached max 30 s.
- Output (API v2.0.0): enum values are canonical English (low/medium/high, ok/warning/unknown, no_data …); ?lang=da returns the previous Danish values. *_en mirror fields are deprecated (removal in v3).
- OpenAPI: https://holder-check.restockalarm.workers.dev/openapi.json
- Manifest: https://holder-check.restockalarm.workers.dev/.well-known/x402.json

## Endpoints
- GET https://holder-check.restockalarm.workers.dev/v1/holders?address={address} — $0.02 — Holder analysis for an ERC-20 token on Base: top 10 holders with type and known label (label, category, source), wallet concentration, distribution and bundling check

## Related
- https://token-verdict.restockalarm.workers.dev — One-call verdict: all 4 checks + English conclusion (Base, $0.05)
- https://token-risk.restockalarm.workers.dev — Token risk score (Base)
- https://rug-check.restockalarm.workers.dev — Rug-pull detector (Base)
- https://momentum-score.restockalarm.workers.dev — Momentum score (Base)
- Token Safety suite: https://product-katalog.restockalarm.workers.dev/token-safety
- MCP server (same tools incl. token_verdict; x402 $0.02, verdict $0.05): https://token-safety-mcp.restockalarm.workers.dev/mcp
- Catalog: https://product-katalog.restockalarm.workers.dev/llms.txt