Holder analysis on Robinhood Chain: snapshots, diamond hands and bubble maps

Price tells you what a token is worth. Holders tell you who decides what happens next: how concentrated supply is, whether early buyers are still in, and whether a “community” of holders is really a handful of wallets funded by the same source. This guide walks through four levels of holder analysis with the Crius API, from a quick concentration check to a full bubble map.

1. Concentration at a glance

The token profile has a holder summary:

"holders": {
  "count": 201,
  "top10_pct": 88.5277,
  "dev_holding": false,
  "dev_pct": 0,
  "burned_pct": 2.98401,
  "locked_pct": 8.16327
}

That’s Charge AI at time of writing: 201 holders, but the top ten hold about 88% of supply. Before reading too much into it, remember that infrastructure counts as holders on-chain: pools, LP lockers and burn addresses. A graduated launchpad token often has a large share sitting in its pool. The live holder list labels those addresses so you can tell real holders from plumbing, and exclude=infra removes them from the numbers.

2. Holders at any point in the past

“Who held this token when it crossed a $50k market cap, and are they still holding?” is a common question, and a hard one to answer from raw transfers. Holder snapshots answer it directly:

curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/snapshot?at=mcap:50000&compare_to=now&exclude=infra" \
  -H "x-api-key: $CRIUS_API_KEY"

The point in time can be an exact block (block:95000000), a time (ts:1792000000000), a market-cap level (mcap:50000, the first time it was crossed) or a lifecycle label (launch, graduation, ath). compare_to=now adds each holder’s balance change since then.

3. Diamond hands: who held through a window

A snapshot is a single moment. To find wallets that held continuously through a period, use cohorts:

curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/holders/cohort?from=mcap:10000&to=now&min_usd=50&continuous=true&reset_on=sell&exclude=infra,bots" \
  -H "x-api-key: $CRIUS_API_KEY"

This returns wallets that held at least $50 of the token from the moment it hit $10k market cap until now, without selling. reset_on decides what breaks the streak (sell by default, or any_decrease, or below_threshold), and entered_before=mcap:20000 keeps only wallets that were in early. It’s the query behind “early believers” lists and holder-reward airdrops.

For the shape of the holder base over time, holder history gives the holder count per interval, with your own definition of a holder (for example, at least $10).

4. Bubble maps: are these holders really independent?

Concentration numbers assume each address is a separate holder. Often they aren’t: one person splits a buy across many wallets, all funded from the same source. A bubble map draws the top holders as nodes and connects the ones that are related.

curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/bubblemap?top=100&exclude=infra" \
  -H "x-api-key: $CRIUS_API_KEY"

/bubblemap returns nodes (holders with balance and share) and edges between them: direct funding, transfers of the token, a common funder, and same-block buys. Render it with any force-directed graph library (d3-force, Sigma.js, Cytoscape) and clusters jump out. Pass block for a historical map, for example right after launch. Keep exclude=infra: shared infrastructure such as the Uniswap v4 PoolManager would otherwise appear as a top holder and link unrelated wallets through it.

For the launch itself (snipers in the first blocks, coordinated bundles, and who funded them), see the dedicated guide: detect token bundles, sniper wallets and connected holders.

Putting it together

A practical holder review for a token you’re considering:

1. Profile: holder count and top-10 share, with infrastructure excluded.
2. Bundles: what share do snipers and bundled wallets hold? (how to read a bundle report)
3. Bubble map: do the top holders form one or two big clusters?
4. Snapshot at launch vs now: did early wallets sell into later buyers?
5. Cohort: how many wallets actually held through the last move?

Each step is one API call; the token holders API guide covers snapshots and cohorts in depth. Holder endpoints need a key (snapshots and live holders are on the Free plan; cohorts, history and bubble maps on Starter and up): create one free and explore in the playground.