Bubblemaps

Bubblemaps is a visual onchain analytics platform focused on wallet investigation, token holder analysis, and blockchain activity mapping. The platform renders on-chain relationships as interactive bubble maps — node-based visual graphs where wallets appear as circles whose size reflects their token holdings, and connecting lines indicate transfer relationships between addresses. This visual approach makes it possible to identify holder concentration patterns, wallet clusters, and token flow chains at a glance without requiring manual inspection of raw blockchain data

Bubblemaps supports multiple blockchain networks from a single interface, allowing analysts to investigate token holder distributions across EVM-compatible chains and other supported networks without switching between separate data sources. The platform operates under a proprietary license and carries the BMT token. Bubblemaps is accessible through the main interface at bubblemaps.io and the v2 application at v2.bubblemaps.io, with integration capabilities available for developers through iFrame embedding and a Data API documented at docs.bubblemaps.io

The primary user experience on Bubblemaps centers on entering a token contract address to generate an interactive bubble map of that token's holder landscape. The platform queries onchain holder data and renders each wallet as a bubble on a spatial graph, with bubble size proportional to the percentage of the token supply held by that address. Wallets that have transferred tokens between one another are connected by lines on the graph, making it possible to trace direct relationships and shared activity between addresses in the holder set

Navigating the map allows analysts to click individual bubbles to inspect the wallet address, holding percentage, and connected transfer partners for each node. The interactive layout can be explored spatially to identify clusters — groups of wallets positioned close together based on the density of their mutual transfer relationships. This cluster detection view surfaces patterns such as coordinated distribution from a single source wallet, multi-hop token routing, and concentrated holder groups that may be difficult to identify from a standard sorted holder list

The bubble map visualization is the core analytical layer of Bubblemaps, representing token holder distributions as a spatial graph where positional proximity reflects the strength of on-chain transfer relationships between addresses. Each bubble corresponds to a unique wallet address, with visual size encoding the relative share of token supply held, and connecting lines indicating historical token transfers between pairs of wallets in the holder set. This graph-based encoding makes it possible to identify structural patterns in token distribution — such as concentrated supply clusters or multi-step distribution chains — through visual inspection rather than query-based data analysis

Holder cluster detection on Bubblemaps surfaces groups of wallets that share a pattern of mutual token transfers or that received tokens from a common source address. By positioning related wallets in proximity on the map and rendering their connections visually, Bubblemaps makes it possible to distinguish naturally dispersed holder distributions from concentrated cluster structures. This feature is particularly relevant for token due diligence, where tightly grouped holder clusters may indicate coordinated accumulation, airdrop farming, or supply concentration by a small number of related addresses

Token flow investigation on Bubblemaps extends beyond static holder snapshots by allowing analysts to trace the path of token transfers across multiple hops through the holder graph. When a wallet passes tokens to a second wallet, which then distributes to additional addresses, the chain of those transfers is encoded in the connection structure of the bubble map, allowing the analyst to follow the flow visually across several transaction steps. This trace capability makes Bubblemaps applicable for tracking token distribution patterns from initial contract deployments, large wallet movements, or early holder activity through subsequent transaction chains on EVM-compatible networks

The iFrame integration and Data API documented at docs.bubblemaps.io/introduction provide two routes for embedding or accessing Bubblemaps functionality outside the main application interface. The iFrame path allows developers to embed a live Bubblemaps visualization for a specified token directly into an external webpage, rendering the interactive bubble map within a host application without requiring end users to navigate to bubblemaps.io independently. The Data API provides programmatic access to the holder and cluster data that underpins the visual maps, enabling developers to retrieve structured analytics output for specific tokens and integrate those results into custom dashboards, research tools, or third-party analytics applications

Bubblemaps supports a range of onchain analytics and due diligence use cases: retail traders and investors use the bubble map interface to visually assess the holder concentration and transfer history of a token before entering a position; token project teams inspect their own holder distribution maps to understand how supply has moved since launch and identify significant cluster patterns; research analysts use the transfer connection graph to trace multi-hop token flows between addresses on supported EVM-compatible chains; developers and analytics platform operators embed Bubblemaps visualizations via iFrame to offer visual holder analysis features without building independent onchain data infrastructure; and BMT token holders engage with the platform ecosystem tied to the native token

Developer integration with Bubblemaps is supported through two access paths described in the documentation at docs.bubblemaps.io/introduction: an iFrame embedding interface and a Data API. The iFrame path allows a Bubblemaps bubble map for a specific token contract address to be rendered within an external webpage or application, as detailed in the integration guide at wiki.bubblemaps.io/learn-more/integrate-bubblemaps. The Data API provides structured programmatic access to the holder distribution and cluster data behind each bubble map visualization, enabling developers to retrieve and use that data within their own applications, research workflows, or onchain analytics dashboards without directing users to the Bubblemaps interface directly

Bubblemaps is a read-only analytics and visualization platform — it does not require wallet connection for standard bubble map and holder analysis activity, and does not custody user assets or execute on-chain transactions on behalf of users. A public GitHub repository is available at github.com/bubblemaps for reference alongside the developer documentation at docs.bubblemaps.io and the wiki at wiki.bubblemaps.io. Users and developers integrating the iFrame or Data API should review the available documentation and the integration guide, and apply standard security practices appropriate to embedding third-party content and handling API responses within their own applications

Bubblemaps provides a distinctive approach to onchain analytics by rendering token holder distributions and wallet transfer relationships as interactive visual bubble maps, making it possible to identify holder concentration patterns, cluster structures, and token flow chains through spatial visualization rather than tabular data analysis alone. The platform covers multiple blockchain networks, supports iFrame embedding and Data API access for developer integration, and carries the BMT token. Users and teams evaluating Bubblemaps should review the documentation at docs.bubblemaps.io and the integration guide to determine whether the visual analytics format fits their onchain investigation and due diligence requirements