Quickstart
Embed an interactive holder map in one line of code. Zoom, hover, click a bubble to highlight its cluster, and copy addresses from the list.
1. Paste the iframe
<iframe src="https://bubblemaps.dev/embed/map?chain=solana&address=8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump&partnerId=demo" allow="clipboard-write" style="width:100%;height:700px;border:none;"></iframe>Keep allow="clipboard-write" so the copy buttons work inside the frame.
2. Build your snippet
Parameters
chain | solana. See supported chains at /v0/chains. Other chains show a "Solana only for now" state. |
address | Token mint address. |
partnerId | demo works anywhere with a watermark and tighter rate limits. Create your own at Partners. |
theme | dark (default) or light. Partner color themes apply automatically. |
limit | Top holders to show: 80 (default), 250, 500. |
hideList | 1 hides the address list panel. |
Recommended sizes
- Desktop: full width, 700px tall (minimum 480px).
- Sidebar or card: 400×500 with
hideList=1. - Mobile: full width, 560–640px tall. The list stacks under the map below 640px wide.
Partner IDs and domains
Partner IDs are public, not secret. Each one lists the domains allowed to frame it; Bubbles sends a matching Content-Security-Policy: frame-ancestors header, so other sites can't embed your ID. Maps are read from cache; a token that hasn't been mapped yet is queued and the frame shows progress until it's ready.