CRIUS Docs
API status Get API key
Bundles & bubble maps

Bubble map

Holder graph

GET https://api.crius.sh/v1/{chain}/token/{address}/bubblemap
Starter and above 10 credits per call Updated Oct 28, 2026

The top holders (top, up to 500) as nodes and the links between them as edges: funding between holders, token transfers between holders, and funders shared by two or more of them. Each cluster lists its members and why they are linked (links: shared funders, funding and transfers between them).

Only real holders are on the map. Pools, the Uniswap V4 PoolManager, LP lockers, hooks, burn addresses, routers, other contracts and exchanges are listed under hidden_infra with their share. Funding from exchanges, bridges and app relayers (one signer paying the same 100+ wallets again and again) never links wallets, and dust sends from lookalike addresses (address poisoning) are ignored. include=infra,hubs,funders brings infrastructure, hub funding and single-wallet funders back. Pass block for a historical map. Ready to render with any force-directed graph library.

Nodes = holders (+ funders shared by 2+ of them), edges = funding / transfers / common funders; clusters with the links that make them. Infrastructure (pools, PoolManager, lockers, hooks, burn, routers, contracts, exchanges) is listed under hidden_infra, not on the map.

Path parameters

chainstringrequired

Chain slug (robinhood) or chain id (4663).

addressstringrequired

Contract or wallet address, any case (0x…, 20 bytes).

Query parameters

topinteger Default 100

Number of top holders to include as nodes. Up to 500.

edgesstring Default funding,transfers,common_funder

Which links to include between holders.

includestring

Comma list of hidden classes to bring back: infra (pools, PoolManager, lockers, hooks, burn, routers, contracts, exchanges), hubs (funding from exchanges, bridges, relayers), funders (external funders of a single wallet). Infra | hubs | funders (comma-separated)

blockinteger

Build the map as of this block (historical).

Guides that use this endpoint

Get the holders of a Robinhood Chain token (token holders API)Robinhood Chain token holders API: get any token's top holders in one call, with balance, share of supply, USD value, labels, holder count and top-10 share.Read a token's bubble map and holder clustersGet a Robinhood Chain token's top holders as a graph, with the funding and transfer links that group them. Real examples, with and without clusters.Find wallets connected by fundingFind who funded a Robinhood Chain wallet, which wallets it funded, who it swaps tokens with and who shares its funder, to spot alt wallets, dev links, sybils.Robinhood Chain API for risk and complianceScreen Robinhood Chain tokens and wallets with the Crius API: security checks, insider launches, funding links, developer history and LP locks.

Errors

Errors come back as { "error": { "code", "message" } } with the matching HTTP status: 400 bad parameter, 401 missing or invalid key, 403 endpoint above your plan, 404 unknown token or address, 429 rate limit or credits used up (with Retry-After). See Errors.

More bundles & bubble maps endpoints

GET/token/{address}/bundlesSnipers, bundles & clustersStarter · 10 cr

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

Get a free API key See plans
  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card