# CabalSpy

> Labaled wallet API on Solana, BNB, Base, ETH with over 1,600+ wallets for KOL, Smart Moeny and Whales.

## Docs

- [Introduction](https://docs.cabalspy.xyz/get.md)
- [Get an API Key](https://docs.cabalspy.xyz/api-key.md): Create a free CabalSpy account, get your API key from the dashboard, and authenticate REST and WebSocket requests in seconds.
- [Pricing](https://docs.cabalspy.xyz/pricing.md): CabalSpy API pricing from a free tier to enterprise, with monthly credits, rate limits and REST plus WebSocket access across Solana, BNB, Base and ETH.
- [KOL Bundle](https://docs.cabalspy.xyz/guides/kol-bundle.md): Detect coordinated bundles where a KOL and side wallets buy a token together, with a confidence score and proof. Endpoints, chains, first steps.
- [KOL Leaderboard](https://docs.cabalspy.xyz/guides/leaderboard.md): Rank the best tracked wallets by PnL, win rate, trades or volume on any chain. Endpoints, chains, first steps and a cookbook.
- [PnL Calendar](https://docs.cabalspy.xyz/guides/pnl-calendar.md): A month by month calendar of a wallet realized PnL, one colored cell per day. Endpoints, chains, first steps and a cookbook.
- [KOL Real-Time Holding Table](https://docs.cabalspy.xyz/guides/realtime-holding-table.md): A live table of everyone holding a token, merging holder positions, native balance and bundle flags. Endpoints, chains, first steps and a cookbook.
- [KOL Signal Service](https://docs.cabalspy.xyz/guides/signal-service.md): Surface tokens where several tracked wallets buy together, and stream live entry and exit alerts. Endpoints, chains, first steps and a cookbook.
- [KOL Supply Holding](https://docs.cabalspy.xyz/guides/supply-holding.md): Show how much of a token supply tracked wallets hold, updating live from the trade stream. Endpoints, chains, first steps and a cookbook.
- [KOL Wallet Count](https://docs.cabalspy.xyz/guides/wallet-count.md): Show how many tracked KOL wallets are in a token as a live badge or activity signal. Endpoints, chains, first steps and a cookbook.
- [KOL Widget](https://docs.cabalspy.xyz/guides/widget.md): 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.
- [KOL Wallet Tracking](https://docs.cabalspy.xyz/guides/kol-wallet-tracking.md): Turn a wallet address into a full profile with stats, realized PnL, holdings and a PnL calendar. Endpoints, chains, first steps and a cookbook.
- [KOL Chart Events](https://docs.cabalspy.xyz/guides/chart-events.md): Drop live buy and sell bubbles onto a price chart at the moment a KOL trades. Endpoints, chains, first steps and a reference.
- [Data APIs](https://docs.cabalspy.xyz/Data-APIs.md)
- [List](https://docs.cabalspy.xyz/list.md): Fetch all tracked KOL, Smart Money and Whale wallets on Solana, BNB, Base and ETH with name, avatar, socials and copytrade link.
- [Lookup](https://docs.cabalspy.xyz/lookup.md): Look up any wallet address across all chains and wallet types to check if CabalSpy tracks it and return its KOL, Smart or Whale profile.
- [Leaderboard](https://docs.cabalspy.xyz/leaderboard.md): Rank tracked KOL, Smart Money and Whale wallets by trading volume for a period, with realized PnL, win rate and trade counts.
- [Tracker](https://docs.cabalspy.xyz/tracker.md): Full trading profile for one wallet over a period, with period stats, win rate distribution, active and historical tokens, a realized PnL chart and recent trades.
- [Holdings](https://docs.cabalspy.xyz/holdings.md): Current on-chain token balances of a wallet, read live from the chain via Moralis. Period independent, no cost basis.
- [PnL Calendar](https://docs.cabalspy.xyz/pnl-calender.md): Day by day realized PnL calendar for a wallet, grouped by month, with per day profit and loss, volume, trade counts and win loss streaks.
- [History](https://docs.cabalspy.xyz/history.md): Complete lifetime trading history of a wallet, with lifetime stats, win rate distribution, a per token overview and a paginated trade log.
- [Connections](https://docs.cabalspy.xyz/connections.md): Find wallets connected to a given wallet by shared token activity, ranked by how many tokens they traded in common over the last 30 days.
- [Stats](https://docs.cabalspy.xyz/stats.md): Aggregate trading statistics for one token across tracked wallets, with current market cap, holder totals, flow stats and a per trader breakdown.
- [Holders](https://docs.cabalspy.xyz/Holders.md): The tracked wallets holding a token, ranked by amount held, each with live position, unrealized PnL, remaining value and entry market cap.
- [Transactions](https://docs.cabalspy.xyz/transactions.md): The individual buy and sell transactions of tracked wallets on one token, newest first, each with the holder position after the trade.
- [Bundle Snapshot](https://docs.cabalspy.xyz/bundle.md): Detect coordinated KOL bundles on a Solana token, the side wallets that buy alongside a KOL in the same block, with proof and live positions.
- [Latest](https://docs.cabalspy.xyz/latest.md): The most recent transactions of tracked wallets on a chain and wallet type, newest first, each with trader profile and position after the trade.
- [Timerange](https://docs.cabalspy.xyz/timerange.md): Transactions of tracked wallets within a recent time window, up to 60 minutes back, newest first, each with trader profile and position.
- [Count](https://docs.cabalspy.xyz/count.md): Count how many transactions tracked wallets made within a time window, up to 24 hours back, optionally filtered to a single token.
- [Volume](https://docs.cabalspy.xyz/volume.md): Total trading volume of tracked wallets within a time window, up to 24 hours back, in native currency and USD, optionally per token.
- [Signals](https://docs.cabalspy.xyz/signals.md): Live trade signals derived from tracked wallet activity, including token clusters where several wallets buy the same token within a time window.
- [Signals History](https://docs.cabalspy.xyz/signals-history.md): Historical cluster signals that would have fired on past days, useful for backtesting a KOL cluster strategy against real outcomes.
- [Analytics](https://docs.cabalspy.xyz/analytics.md): Aggregate analytics over tracked wallets for a period, including most traded tokens, top performing wallets, win rate stats and volume trends.
- [Get Started](https://docs.cabalspy.xyz/get-started.md): Real-time WebSocket streams for trades, holder positions, wallet balances, cluster signals and KOL bundle detection across Solana, BNB, Base and ETH.
- [Transactions Stream](https://docs.cabalspy.xyz/transactions-1.md): Live WebSocket stream of KOL, Smart Money and Whale transactions with running position, bag percentage and supply percentage per wallet.
- [Count Stream](https://docs.cabalspy.xyz/Count.md): Live WebSocket stream of the KOL wallet count per token, updated as tracked wallets buy, for activity indicators and cluster detection.
- [Signal Stream](https://docs.cabalspy.xyz/signal.md): Live WebSocket stream of entry and exit signals when clusters of tracked KOL or Smart Money wallets buy or sell the same token together.
- [Bundle Stream](https://docs.cabalspy.xyz/bundle-1.md): Live WebSocket stream of coordinated KOL bundles on a Solana token, the side wallets buying alongside a KOL, with proof and live positions.
- [Holder Stream](https://docs.cabalspy.xyz/holder.md): Live WebSocket stream of all tracked holders of a token with position, bag percentage, unrealized PnL, remaining value and entry market cap. Solana, BNB, Base, Ethereum and Robinhood.
- [Balance Stream](https://docs.cabalspy.xyz/balance-1.md): Live WebSocket stream of the native balance of tracked wallets, updated on every trade, with previous balance and USD value. Solana, BNB, Base, Ethereum and Robinhood.
- [Widget Pricing](https://docs.cabalspy.xyz/get-started-1.md): CabalSpy embeddable widget plans, a live wallet bubble map you drop in with one iframe. Starter, Pro and Enterprise pricing by domains and daily users.
- [Widget [IFrame]](https://docs.cabalspy.xyz/widget-i-frame.md)
- [Build a Real-Time Holders Tab like Axiom](https://docs.cabalspy.xyz/realtime-holder-table.md)
- [Build a Real-Time Holders tab with Balance and Bundle data](https://docs.cabalspy.xyz/Real-Time-Holders-tab-with-balance-and-bundle.md)
- [Build a Wallet Tracker](https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom.md): Build a full wallet profile page with period stats, a realized PnL chart, holdings and a month by month PnL calendar, step by step in TypeScript.
- [Live Wallet Count Badge](https://docs.cabalspy.xyz/count-1.md): Show how many tracked KOL wallets are in a token as a live badge or heat indicator, with a REST poll for a number on demand or a WebSocket for live updates.
- [Supply Held by Wallets](https://docs.cabalspy.xyz/build-a-supply-and-bag-holdings-badge.md): Show how much of a token supply tracked KOL, Smart Money and Whale wallets hold, per wallet and combined, from one REST call. Step by step in TypeScript.
- [Build a Signal Service](https://docs.cabalspy.xyz/build-a-signal-for-wallet-cluster-buying.md): Turn wallet activity into trade signals, surface tokens where several tracked wallets buy together, and stream live entry and exit alerts. Step by step in TypeScript.
- [Build a Trader Leaderboard](https://docs.cabalspy.xyz/build-a-leaderboard-like-axiom-vision.md): Build a ranked leaderboard of top KOL, Smart Money and Whale traders by PnL, win rate, trades or volume, with instant client side sorting. Step by step in TypeScript.