# CabalSpy

> KOL and Smart Money wallet API on Solana, BNB Chain, Base, Ethereum and Robinhood Chain: 3,000+ labeled KOL, Smart Money and Whale wallets via REST, WebSocket, SDKs and MCP.

- [Introduction](https://docs.cabalspy.xyz/get.md): CabalSpy is a real-time KOL and Smart Money wallet API: 3,000+ labeled wallets on Solana, BNB Chain, Base, Ethereum and Robinhood Chain via REST, WebSocket, SDKs and an MCP server.
- [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 Chain, Base, Ethereum and Robinhood Chain.
- [SDKs](https://docs.cabalspy.xyz/sdks.md): Official CabalSpy SDKs for TypeScript, Python and Rust: typed access to KOL, Smart Money and Whale wallet data, leaderboards, signals and real-time streams.
- [MCP Server](https://docs.cabalspy.xyz/mcp-server.md): Connect Claude, Cursor, VS Code and other AI clients to CabalSpy wallet data. Remote MCP server with 21 read-only tools for KOL, Smart Money and Whale wallets.
- [x402 for AI agents](https://docs.cabalspy.xyz/x402.md): AI agents pay per request in USDC for CabalSpy wallet data with x402: no account, no signup, no API key. Clients for TypeScript and Python with built-in spend limits.
- [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 Chain, Base, Ethereum and Robinhood Chain 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 Chain, Base, Ethereum and Robinhood Chain.
- [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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.