Holder Bubble Maps Explained: Reading Who Really Holds a Token
2026-10-08
A holder list is a table of addresses and percentages, which hides the question that matters: are these separate people? A bubble map draws each wallet as a circle sized by its balance and pulls wallets that have moved the token between each other into the same group. The Holder Bubble Map in Token Lab builds that picture from the same sampled snapshot as the rest of the chain analysis.
How to read it
- Area is balance. A circle's radius scales with the square root of its share of supply, so a wallet with four times the tokens has twice the radius.
- Colour is group. Wallets linked through observed transfers share a colour and sit together. Unlinked wallets are grey-blue and pools are slate.
- White outline is a fresh wallet created close to the token launch.
- Lines are transfers between two shown wallets; thicker means more transfers.
What a healthy map looks like
Many small, grey circles with no thick lines between big ones. What should make you stop is a large coloured group, especially one with white outlines: several new wallets that funded or sent to each other and together hold a double-digit share. The legend lists each group, its wallet count and combined supply share, so you do not have to estimate by eye.
How the layout is made
The server places circles deterministically: groups get anchor points around a ring, and each circle is placed by an outward spiral from its anchor until it clears every earlier circle. The same snapshot always produces the same map, which makes shared links and cards consistent. At most 200 wallets are drawn.
Where it misleads
Exchanges and routers can link unrelated wallets, and a team that splits funds without moving the token between wallets will not form a group. The map reflects the sample of holders and transfers we could read. Use it to ask better questions, then check the evidence in the full chain analysis view.
API: /api/lab/bubble-map?chain=robinhood&address=0x...&limit=100.
Pricing and limits
Runs are metered. Hindsight tools cost $0.002 a run, Token Lab holder tools $0.01, and Social Pulse or the AI analyst $0.05, taken from account credits. Paid plans include a monthly allowance and then fall back to credits. Anonymous visitors get a few free hindsight samples a day, and any result someone has already computed is free to view for a few minutes. Daily and monthly spend caps apply to every account.
The worked example uses an invented token to show how the score moves; it is not a real project. Run the tool on a real contract to see observed data. Holder data is a sample, linked wallets are observed transfers rather than proof of one owner, and nothing here is financial advice.