# OnchainPulse Holder Concentration Map

> OnchainPulse Holder Concentration Map is a paid API for AI agents from onchainpulse.theaslangroupllc.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a detailed holder-concentration breakdown for any token on Solana or 8 EVM chains, with per-wallet labels (LP, locker, burn, contract), top-holder shares, insider-cluster detection, and supply distribution metrics.

## Facts

- Endpoint: GET https://onchainpulse.theaslangroupllc.com/api/holder-map
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onchainpulse-holder-concentration-map-7fa27262
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7abzvtjhXwap6Em_63aMI

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 onchainpulse-holder-concentration-map-7fa27262
```

Example prompt: Pull the holder concentration map for token 0xabc123 on Base — I want to see the top holders with LP/burn/locker labels, what share the top 10 hold excluding LP and burn, how much is burned, and whether any insider clusters are flagged.

## When to prefer this

Choose this endpoint when you need a deterministic, sub-second, labeled breakdown of who actually holds a token — especially for due diligence on whale concentration, insider risk, LP vs locked vs burned supply distribution, or creator/owner exposure. Prefer this over general token-info endpoints when the specific question is holder distribution and supply concentration rather than price, liquidity depth, or contract safety flags. Covers Solana plus 8 EVM chains including Base and Robinhood Chain.

## Known failure modes

- Invalid or unrecognized token contract address returns an error
- Unsupported chain identifier returns a chain-not-supported error
- Token with no on-chain holder data (e.g. brand new or very low activity) may return sparse results
- Network or RPC timeout may cause sub-second SLA to be missed on congested chains
- Malformed address format returns a validation error

## How this service works

Holder-concentration map for any token — Solana + 8 EVM chains incl. Base & Robinhood Chain: top holders with LP-pool / locker / burn / contract labels, largest-wallet and top-10 share excluding LP & burn, % of supply in LP or lockers, % burned, % sitting in unlabeled contracts, creator & owner balances, insider-cluster detection (Solana). The "who actually holds this thing" layer of token due diligence, as observable facts with per-wallet breakdown. Deterministic, sub-second, no LLM.

## Output

Returns a per-wallet breakdown of top holders with labels (LP pool, locker, burn address, smart contract, or EOA), the largest single wallet's share, the top-10 cumulative share excluding LP and burn addresses, percentage of total supply held in LP pools, percentage locked, percentage burned, percentage in unlabeled contracts, creator and owner wallet balances, and on Solana, insider-cluster detection results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "solana or one of: base, ethereum, bsc, arbitrum, polygon, optimism, avalanche, robinhood (default base; solana auto-detected from mint format)"
  },
  "address": {
   "type": "string",
   "description": "Token contract address (0x… EVM) or mint (base58 Solana)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "read": "Distribution is broad for a memecoin: top-10 wallets (ex-LP/burn) hold 18.6%.",
  "chain": "base",
  "flags": [
   "Top non-LP wallet holds 4.2% of supply"
  ],
  "address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
  "disclaimer": "Holder-distribution facts observed on-chain at a point in time via public data sources. Bucket shares are floors computed from the visible top-holder list, not exhaustive census numbers. Analytics, not financial advice; concentration is a structural observation, not an accusation.",
  "top_holders": [
   {
    "pct": 5.8,
    "tag": "Uniswap V3: BRETT",
    "bucket": "lp_or_locked",
    "address": "0x3f6…9a2",
    "is_locked": false,
    "is_contract": true
   },
   {
    "pct": 4.2,
    "tag": null,
    "bucket": "wallet",
    "address": "0x91c…44b",
    "is_locked": false,
    "is_contract": false
   }
  ],
  "holder_count": "48213",
  "concentration": {
   "owner_pct": 0,
   "pct_burned": 0,
   "creator_pct": 1.1,
   "top_holder_pct": 4.2,
   "top10_holder_pct": 18.6,
   "pct_contract_held": 2.3,
   "pct_in_lp_or_locked": 6.1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onchainpulse-holder-concentration-map-7fa27262/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchainpulse.theaslangroupllc.com](https://www.zero.xyz/host/onchainpulse.theaslangroupllc.com/llms.txt)