KOL Wallet Tracking — one address,
the full trader profile

A KOL wallet tracker API that turns one address into a complete profile: realized PnL, win rate, average hold time, traded tokens, a PnL chart and recent trades for a period you choose, plus live holdings and lifetime history from two more calls.

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 Wallet Tracking

Build a wallet profile page with one API call

What it shows

The detail page behind a tracked KOL, Smart Money or Whale wallet. For a period of 6 hours, 1 day, 7 days or 30 days the tracker returns the trader’s profile (name, avatar, X/Twitter, Telegram, wallet type, most active hours), buy and sell volume, realized PnL in native currency and USD, win and loss counts, best and worst trade, and average hold time.

It also returns a win rate distribution across profit buckets, the tokens the wallet is still holding, the tokens it fully traded through, a realized PnL series for a chart and the most recent trades. Use it as a KOL profile card, a copy-trade research page or the wallet detail view in a terminal.

How it works

Call the tracker endpoint with blockchain, address and period. The response carries the whole profile, so one request renders the page. The data is served from a permanently cached, WebSocket-driven store.

Add more depth with separate calls. Holdings returns the wallet’s current on-chain token balances including the native coin; it has no cost basis and therefore no PnL, and the wallet must be tracked by CabalSpy. History returns lifetime stats, a per-token overview and a trade log you page through with next_cursor. Lookup takes only an address, searches all chains and wallet types, and tells you through the found field whether CabalSpy tracks the wallet and under which name and category.

RESTGET /v1/wallets/trackerProfile, period stats, win rate distribution, active and historical tokens, realized PnL chart and recent trades.RESTGET /v1/wallets/holdingsCurrent on-chain token balances of a tracked wallet, including the native coin.RESTGET /v1/wallets/historyLifetime stats, per-token overview and a paginated trade log, newest first.RESTGET /v1/wallets/lookupCheck whether an address is tracked and return its name, socials, wallet type and chain.

Supported chains: Solana, BNB Chain, Base, Ethereum and Robinhood Chain (blockchain values solana, bnb, base, eth and rh). Solana has KOL, Smart Money and Whale wallets; BNB Chain, Base and Robinhood Chain have KOL and Smart Money; Ethereum has KOL wallets.

Quick start

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

REST · cURL

curl "https://api.cabalspy.xyz/v1/wallets/tracker?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&period=7d&api_key=YOUR_KEY"

REST · JavaScript

const p = new URLSearchParams({
  blockchain: "solana",
  address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
  period: "7d",
  api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/wallets/tracker?${p}`);
const { data } = await res.json();
console.log(data.profile.name, "pnl", data.period_stats.realized_pnl);

REST · cURL (holdings)

curl "https://api.cabalspy.xyz/v1/wallets/holdings?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&api_key=YOUR_KEY"

Who builds this

Trading terminals — the wallet detail view behind every address in a trade feed
Copy-trading apps — a research page to check a trader’s PnL and win rate before following
Telegram and Discord bots — a profile card for a wallet command
Analysts — lifetime trade logs and per-token results for deep research on one trader

Frequently asked questions

How do I build a KOL wallet tracker?

Call GET https://api.cabalspy.xyz/v1/wallets/tracker with blockchain, address and period (6h, 1d, 7d or 30d). The response contains the wallet profile, period stats with realized PnL, a win rate distribution, active and historical tokens, a realized PnL chart series and recent trades. Add GET /v1/wallets/holdings for current balances and GET /v1/wallets/history for the lifetime trade log.

How do I get the PnL and win rate of a wallet?

The tracker endpoint returns realized_pnl, realized_pnl_usd and realized_pnl_percentage for the chosen period, together with win_count, loss_count and a win rate distribution across profit buckets. For lifetime figures, GET /v1/wallets/history returns lifetime_stats with realized PnL and win rate over the whole history of the wallet.

Can I see what a wallet holds right now?

Yes. GET https://api.cabalspy.xyz/v1/wallets/holdings returns the current on-chain token balances of a tracked wallet, including the native coin. It reads raw balances, so it has no cost basis and no PnL. While the balance cache warms up the response can contain loading: true; call it again shortly.

How do I check whether a wallet address is a known KOL?

Call GET https://api.cabalspy.xyz/v1/wallets/lookup with the address. It searches all chains and wallet types and returns found: true with name, avatar, socials, wallet type (kol, smart or whale) and chain, or found: false when CabalSpy does not track the address.

Is there a ready-made wallet tracker example?

Yes. The CabalSpy docs include a wallet tracker cookbook that builds the profile page and PnL calendar, and an open-source Wallet Tracker demo is available on GitHub.

Go deeper

Related use cases

PnL CalendarDaily realized PnL per wallet, grouped by month KOL LeaderboardRank KOLs by PnL, win rate, trades or volume KOL Holders TableLive table of KOL and Smart Money holders for any token All use cases11 ways to build with the KOL API

Build KOL Wallet Tracking 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