KOL Widget — live KOL activity,
no frontend work

The KOL widget is a single iframe for your trading terminal or website. It shows how many KOL and Smart Money wallets are involved in a token as a live bubble map. CabalSpy handles the data, styling and live updates.

Get free API key Read the docs

3,000+

Labeled Wallets

1.5M+

Wallet TXN / month

10M+

API Requests / month

20+

Integration Partners

99.90%

Uptime SLA

Trusted by

Use Case · KOL Widget

Embed a KOL widget with one line of code

What it shows

The KOL widget renders a live bubble map of labeled wallet activity for an address: the KOL and Smart Money wallets involved, animating as new buys and sells arrive. Users see at a glance how many labeled wallets are in a token without leaving your page.

On Solana the widget shows KOL, Smart Money and Whale rings; on the other chains it shows KOL and Smart Money rings. Values are denominated in the chain’s native currency.

How it works

There are no API calls to wire up. The widget is configured entirely through query parameters on the /widget URL: address (required, the token address) and chain. Always set chain explicitly, because EVM chains share the 0x… address format and cannot be told apart from the address alone. Once loaded, the widget keeps itself current over a WebSocket.

The widget fills the iframe, so you size the iframe. A roughly square area (1:1 to 1:1.2) works best, with at least about 360 px of height on mobile. The widget only renders on approved domains: send CabalSpy the hostnames you embed on and they are added to the allow-list, subdomains included. Until then the iframe’s data calls return 403; opening the widget URL directly in a browser tab always works for testing.

Widget plans are priced by domains and daily users: Starter at $199 per month (about 250 daily users, one domain), Pro at $499 per month (about 1,000 daily users, up to three domains) and Enterprise with custom limits and unlimited domains. See pricing.

widget.cabalspy.xyz/widgetOne iframe URL with address and chain query parameters. Data, styling and live updates are handled by CabalSpy.

Supported chains: Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana shows KOL, Smart Money and Whale rings; the other chains show KOL and Smart Money.

Quick start

Get a free key from the API dashboard (10,000 credits per month, no credit card), then:

Embed · iframe

<iframe
  src="https://widget.cabalspy.xyz/widget?address=YOUR_TOKEN_ADDRESS&chain=SOL"
  width="100%"
  height="600"
  style="border:0;border-radius:16px;overflow:hidden"
  loading="lazy"
  referrerpolicy="strict-origin-when-cross-origin"
  title="CabalSpy Wallet Widget">
</iframe>

Embed · responsive wrapper

<div style="position:relative;width:100%;max-width:520px;aspect-ratio:1/1.15;margin:auto">
  <iframe
    src="https://widget.cabalspy.xyz/widget?address=YOUR_TOKEN_ADDRESS&chain=SOL"
    style="position:absolute;inset:0;width:100%;height:100%;border:0;border-radius:16px"
    loading="lazy" title="CabalSpy Wallet Widget"></iframe>
</div>

Who builds this

Trading terminals — labeled wallet activity on the token page without building a frontend for it
Token and community sites — a live view of the KOLs and Smart Money in the token
Dashboards and screeners — a drop-in panel next to the chart
Teams without frontend capacity — KOL data in the product the same day, no API integration

Frequently asked questions

How do I embed a KOL widget on my website?

Add one iframe that points to https://widget.cabalspy.xyz/widget with the query parameters address and chain, for example ?address=...&chain=SOL. Before it renders on your site, your domain has to be on CabalSpy’s allow-list, so send the hostnames you embed on. No API key handling or frontend code is needed.

What does the KOL widget show?

A live bubble map of labeled wallet activity: the KOL and Smart Money wallets involved, updated over a WebSocket as buys and sells arrive. On Solana it shows KOL, Smart Money and Whale rings; on the other chains KOL and Smart Money rings.

Which chains does the KOL widget support?

Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Set the chain parameter explicitly, because EVM chains share the 0x address format. Chain values include SOL, BNB, BASE and RH (Robinhood).

How much does the KOL widget cost?

Widget Starter costs $199 per month for about 250 daily users on one domain. Widget Pro costs $499 per month for about 1,000 daily users on up to three domains and adds priority support. Enterprise has custom pricing with unlimited domains and custom user limits. A daily user is a unique visitor who loads the widget on your site in a day.

Why is the widget blank or returning 403?

The embedding domain is not on the allow-list yet, or the address has no tracked wallets. Confirm the domain was approved and that address matches the chain parameter. Opening the widget URL directly in a browser tab always works, which is useful for testing.

Go deeper

Related use cases

KOL Wallet CountA live number: how many KOL wallets are in a token KOL Holders TableLive table of KOL and Smart Money holders for any token KOL Chart EventsKOL buys and sells as markers on your token chart All use cases11 ways to build with the KOL API

Build KOL Widget into your product. Start free today.

10,000 free credits every month, REST and WebSocket access, no credit card. Plans from $49/month.

Get free API key Read the docs See pricing