Embeds
Holders, mapped.
On your own site.
Shrinemaps draws a token's largest holders as bubbles, links the wallets that belong together and groups them into clusters, with launch bundles, bundlers and Proxima bundles caught. It goes on your site in one iframe. The OHLCV chart puts live 1-second candles there too.
Shrinemaps on Developer and Professional, its history on Professional. The chart from Lite.
01Reading the map
Who holds it, and who's together.
One bubble per holder, sized by its share of the supply. The map above is live: a heavily bundled launch, picked anew every 30 minutes. Hover a bubble, drag the map, open the cluster.
Open the full mapBundles caught
Wallets that bought in the launch slot with the dev, or traded through a bundler, Proxima bundles included, are linked, with a red bundler dot.
Shared funders
One wallet sent the other its first SOL, or both got their first SOL from the same address, shown as a small funder dot between them.
Clusters
Wallets linked together share a colour and count as one cluster: likely one hand. The side panel lists the clusters with their combined share.
Known traders
KOLs show as their picture, with their name and share. An exchange funds everyone, so it shows as a label, never as a link.
Included in
Professional
The map's history. The map keeps snapshots of itself, and a slider under it goes back in time over them. On Developer the map is live only.
- Seven days of history on your site, through the signed
?h=…in the frame the API hands you - Ask for the frame when you build the page, or at least once a day
- 10 IP addresses for your servers, where Developer has 3
02One iframe
Register, paste, done.
Your servers' addresses go on the dashboard and the frame goes in your page. From there the map runs on its own.
- 1Register your servers
Add their IP addresses on the Embeds tab of your dashboard, up to 3 on Developer and 10 on Professional.
within seconds - 2Paste the frame
Put the token's mint in the frame's address, or ask the API from your server, with your key, for the frame ready to paste.
one iframe - 3It keeps itself current
The map refreshes while it is open. Links fill in as more of the token's wallets are looked at, so a fresh token's map grows over its first minutes.
every few seconds
- Size it.The map fills its frame. Give it the full width of your column and at least 480 px of height; 600 suits a token page. It works on phones too.
- Pick how many holders.
?n=sets how many of the largest holders the map shows at first: 50, 100 or 200, 100 by default. The viewer can change it in the map. - Link the full map.The API's answer carries
page, the same map as its own page on maps.shrine.trade, for a "full map" link.
Paste the frame, with the token's mint in the address.
<iframe
src="https://maps.shrine.trade/embed/sol/<mint>"
title="Holder map"
width="100%"
height="600"
style="border:0"
loading="lazy"
allow="clipboard-write"
referrerpolicy="no-referrer"
sandbox="allow-scripts allow-same-origin allow-popups
allow-popups-to-escape-sandbox"
></iframe>Ask from your server, a whitelisted address, with your Developer or Professional key.
const res = await fetch(
"https://sol.shrine.trade/api/maps/<mint>/embed",
{ headers: { "x-api-key": process.env.SHRINE_API_KEY } },
);
const { url, page, iframe } = await res.json();
// Put `iframe` into the HTML your server sends.Optional: the map tells your page which token it shows and which wallet someone clicked.
const MAPS = "https://maps.shrine.trade";
const frame = document.querySelector(
`iframe[src^="${MAPS}/embed/"]`,
);
window.addEventListener("message", (e) => {
if (e.origin !== MAPS || e.source !== frame.contentWindow) return;
const m = e.data;
if (m?.type === "shrinemaps:ready")
frame.contentWindow.postMessage({ type: "shrinemaps:host" }, MAPS);
if (m?.type === "shrinemaps:coin")
document.title = `${m.symbol} holders`;
if (m?.type === "shrinemaps:wallet")
window.open(`https://solscan.io/account/${m.wallet}`,
"_blank", "noopener");
});03OHLCV chart
1-second candles, on your page.
A small, framework free candlestick chart for any Solana memecoin. It streams live 1-second candles over subscribe_ohlcv, seeded with ohlcv_history, and draws them with KLineChart. Below, in demo mode: the candles are made in your browser, with no API call and no key.
Live candles
Every token's candles from Lite. Free covers one token, with a free key from the dashboard, and the history seed runs without a key once a minute.
subscribe_ohlcvOpen source
The app is on GitHub as shrine-ohlcv-chart, with a "pick a live token" button that grabs a freshly launched pool from the free subscribe_new_tokens stream.
On your site
3 IP addresses on Lite, 10 on Developer and 25 on Professional. Add the addresses of the servers that load it on the dashboard.
Plans and limits04Plans
Maps from Developer. Charts from Lite.
Your plan sets how many server addresses can load each embed. Professional adds the map's history.
| Free | Lite | Developer | Professional | |
|---|---|---|---|---|
| Shrinemaps bundle detection on your site | – | – | 3 IP addresses | 10 IP addresses, with the map's history |
| OHLCV chart on your site | – | 3 IP addresses | 10 IP addresses | 25 IP addresses |
| Live candles | 1 token, 1 socket, free key from the dashboard | every token, 3 sockets | every token, 10 sockets | every token, 15 sockets |
| Candle history | 1 a minute | 1 a second | 5 a second | 15 a second |
Add the addresses of the servers that load them on the dashboard. Every limit is in Plans and limits. Prices are on the pricing page.
What do I need to embed Shrinemaps?
A Developer or Professional plan: your API key, and the IP addresses of your servers, up to 3 on Developer and 10 on Professional. Add them yourself on the Embeds tab of your dashboard; they work within seconds.
How does Shrinemaps spot bundles?
A line joins two wallets that belong together: one sent the other its first SOL, both got their first SOL from the same address, both bought in the launch slot with the dev, or both traded through a bundler, Proxima bundles included. Wallets linked together share a colour and count as one cluster: likely one hand.
What does Professional add to the map?
The map's history. The map keeps snapshots of itself, and a slider under it goes back in time over them. With a Professional key, the frame the API hands you carries a signed ?h=… that lets the map show it for seven days, so ask for the frame when you build the page, or at least once a day. On Developer the map is live only.
Is the frame safe to put on my site?
It runs Shrinemaps' own code and reads Shrine's data; it cannot change or navigate your page. With referrerpolicy="no-referrer" the map never learns which page it is on. There is no wallet connection, no account and no buttons that act for your visitors.
Can I put a candle chart on my site?
Yes. The OHLCV chart is a small, framework free app, open source on GitHub, that streams live 1-second candles over subscribe_ohlcv, seeded with ohlcv_history, and draws them with KLineChart. On your site it comes with Lite, Developer and Professional, for 3, 10 or 25 IP addresses.
Put the map on your page.
A Developer key and your servers' addresses, and the map works on your site within seconds.