> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabalspy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# KOL Widget

> An embeddable widget that renders a live bubble map of wallet activity for any address, added with one iframe. Chains, first steps and the guide.

An embeddable widget that renders a live bubble map of wallet activity for any address. You add it with a single iframe, and CabalSpy handles the data, styling and live updates. It is the fastest way to show labeled activity with no frontend work.

## What it shows

A live bubble map of the KOL and Smart Money wallets active on an address, animating as new buys and sells arrive. It drops straight into a trading terminal, a token page or a dashboard.

## Blockchains

Solana, Base, BNB and Robinhood. Solana shows KOL, Smart Money and Whale rings, the others show KOL and Smart Money.

## Endpoints

No API calls to wire up. The widget is a single iframe that reads its configuration from the URL and connects to CabalSpy for live data on its own.

<Card title="Widget guide" href="https://docs.cabalspy.xyz/widget-i-frame">
  The full iframe embed, parameters and options.
</Card>

## First steps

<Steps>
  <Step title="Pick a plan">
    Choose a widget plan from the [pricing page](https://www.cabalspy.xyz/pricing.html), or contact sales for Enterprise.
  </Step>

  <Step title="Whitelist your domain">
    The widget only renders on approved domains. Send us the hostnames you will embed on and we add them to the allow list.
  </Step>

  <Step title="Embed the iframe">
    Drop one iframe into your page with the wallet address and chain. It loads the bubble map and keeps itself live.
  </Step>
</Steps>

```html Embed theme={null}
<iframe
  src="https://widget.cabalspy.xyz/widget?address=YOUR_WALLET&chain=SOL"
  width="100%" height="600"
  style="border:0;border-radius:16px" loading="lazy"
  title="CabalSpy Wallet Widget"></iframe>
```

## Build it

<Card title="Widget guide" href="https://docs.cabalspy.xyz/widget-i-frame">
  Every parameter, chain option and troubleshooting tip.
</Card>