ShrineAPI

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.

yourtoken.site

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 map

Bundles 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.

  1. 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
  2. 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
  3. 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.
Shrinemaps docs

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.

yourtoken.site

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_ohlcv

Open 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.

Chart example

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 limits

04Plans

Maps from Developer. Charts from Lite.

Your plan sets how many server addresses can load each embed. Professional adds the map's history.

FreeLiteDeveloperProfessional
Shrinemaps bundle detection on your site––3 IP addresses10 IP addresses, with the map's history
OHLCV chart on your site–3 IP addresses10 IP addresses25 IP addresses
Live candles1 token, 1 socket, free key from the dashboardevery token, 3 socketsevery token, 10 socketsevery token, 15 sockets
Candle history1 a minute1 a second5 a second15 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.

05FAQ

Questions, answered.

Anything else is in the docs.

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.