Live holder maps, on your site.
Give your token pages the view traders actually want: who holds the supply, which wallets move together and where the exchanges sit. One snippet, any token, any of our five chains.
Free with the “Powered by BananaMaps” badge · Partner plan $99/mo
What it is
BananaMaps Embed is the holder map from bananamaps.io, productized for other sites. It renders inside a frame on your page, sized however you like.
Plans
Both plans are managed from the developer dashboard alongside your API keys, with the same Stripe billing.
- Live holder maps on your site
- "Powered by BananaMaps" badge and link (required)
- All supported chains
- Everything in Free
- Badge optional
- Custom accent color
- Priority refresh of the maps your visitors open
- Email support
Quickstart
Three steps, no build tools.
- Register your site in the dashboard under BananaMaps Embed. You get a partner id (
pid) that starts withbme_. Add the domains you will show the map on. - Paste the snippet where the map should appear and replace
TOKEN_ADDRESS, thechainandYOUR_PID. - Optional, on Partner: add
&badge=0to hide the badge, or&accent=RRGGBBto recolor the map to your brand.
<iframe
src="https://www.bananamaps.io/embed?token=TOKEN_ADDRESS&chain=eth&pid=YOUR_PID"
width="100%"
height="600"
style="border:0;border-radius:12px"
loading="lazy"
title="BananaMaps Embed"
></iframe>Full parameter reference in the docs.
Questions
Do I need a partner id?
On our own properties (bananamaps.io, bananascreener.io) the map works without one. On any other domain the snippet must carry a valid pid; without it, visitors see a short “get a free Embed key” message in place of the map instead of a broken frame.
Partner ids are free. Create one in the dashboard in a few seconds.
Is the badge really required on the Free plan?
Yes. The Free plan shows a small “Powered by BananaMaps” badge with a link in the corner of the map. Hiding it, or covering it with your own layout, is what the Partner plan is for — and it is grounds for the id to be revoked on Free.
What does the Partner plan change?
Three things: the badge becomes optional (badge=0), you can set a custom accent color that replaces the gold in the map (accent=RRGGBB, or saved on the site in your dashboard), and the tokens your visitors open are refreshed with priority. You also get email support.
$99 a month or $990 a year, cancel any time from the dashboard.
How fresh is the data?
The map is drawn from a snapshot of the token's top 150 holders and the transfers between them. Snapshots refresh automatically in the background, with the most-viewed tokens first; Partner sites get priority for the tokens their visitors open. A token nobody has mapped yet shows a short build state the first time it is opened, then loads instantly afterwards.
Can I restrict my id to my domains?
Yes, and you should. Add your hostnames when you register the site (wildcards like *.example.com work). The map only renders when the page showing it matches one of them, so nobody can reuse your id on their own site.
Does the map count against my API quota?
No. BananaMaps Embed and the BananaMaps API are metered separately. Showing a map on your site never consumes API calls from your plan.
Put the map on your site today
Create a free account, register your domain and paste the snippet. Upgrade to Partner when you want it in your colors.