Embed overview
Put SolScanner's interactive token map on your website.
The Embed API lets you show SolScanner's bubble map on your own site via iframe. Contact payments@solscanner.app to get set up with an API key and allowed domains.
Quick start
<iframe
src="https://www.solscanner.app/scanner/TOKEN_MINT/map?embed=1&key=YOUR_API_KEY"
width="100%"
height="600"
sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="border: none; border-radius: 12px;"
></iframe>Replace TOKEN_MINT with any Solana token mint or wallet address, and YOUR_API_KEY with your emb_ key.
URL format
https://www.solscanner.app/scanner/{ADDRESS}/map?embed=1&key={API_KEY}| Parameter | Where | Required | What it does |
|---|---|---|---|
ADDRESS | path | Yes | Token mint or wallet address |
embed | query | Yes | Turns on embed mode. ?embed=1 is canonical; the bare flag ?embed also works. |
key | query | Yes | Your emb_ API key |
The canonical host is https://www.solscanner.app. The apex solscanner.app redirects to www, so use www directly to avoid an extra hop inside the iframe.
Scan modes
Scan mode is optional — if omitted, the address is auto-detected (token → holders, wallet → quick).
Token modes (use with a token mint):
| Parameter | What you get |
|---|---|
holders | Top holders with bundle detection |
traders | Top traders by realized PnL |
Wallet modes (use with a wallet address):
| Parameter | Speed | What you get |
|---|---|---|
quick | Fast | Basic connections |
deep | Medium | Full graph |
max | Slow | Maximum depth |
/scanner/{MINT}/map?embed=1&key={KEY}&tradersWhat users see
The map renders without SolScanner navigation, login prompts, or app chrome. A small "Powered by SolScanner" link appears in the bottom-right. Users can interact with nodes, zoom, pan, filter, and expand wallet details. Rescan works with a 30-second cooldown.
Error rendering
All error states render a visible message inside the iframe — never a blank frame. If the scan fails or the embed key is rejected, the iframe shows:
- The error message in red text (centered)
- A "Back to scanner" link (visible to users navigating inside the iframe)
Because frame-ancestors and cross-origin boundaries prevent the host page from reading the iframe's DOM or JSON responses, surface these states by watching for empty/stalled embed renders on your side (e.g. request timeout on /embeds/validate before mounting the iframe). See Authentication for the validate endpoint.
Usage
Cached results (under 1 hour old) are free. Fresh scans count against your org's limits. When you exceed your limit, the API returns 429.
Limits are set per org. Contact payments@solscanner.app for details.
Troubleshooting
If you see a blank frame or error:
- Check your domain is in the allowed list (see Authentication)
- Verify the API key is correct (pre-flight with validate)
- Confirm you haven't exceeded your usage limits