# 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.
- [Changelog](https://docs.cabalspy.xyz/changelog.md): New features, improvements and fixes in CabalSpy and CabalSpy ID.
- [Try the API without a key](https://docs.cabalspy.xyz/demo.md): Call every CabalSpy REST endpoint and WebSocket stream without signing up, on the public demo: 20 requests per IP per day, data delayed 15 minutes.
- [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 and CabalSpy ID. Remote MCP server with 31 read-only tools for KOL, Smart Money and Whale wallets, curated calls, verified traders and token theses.
- [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.
- [Calls](https://docs.cabalspy.xyz/calls.md): The curated CabalSpy calls from Discord (Gambles, Moderate Gamble, Good Token, Big Token, Whales) with trigger wallets and 24 hour performance.
- [Call Stats](https://docs.cabalspy.xyz/calls-stats.md): Hit rates and performance of the CabalSpy calls per chain and tier: how many reached 2x, 5x and 10x within 24 hours.
- [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.
- [Call Stream](https://docs.cabalspy.xyz/call.md): Live WebSocket stream of the curated CabalSpy calls (Gambles, Moderate Gamble, Good Token, Big Token, Whales) the moment they are posted.
- [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)
- [CabalSpy ID — SocialFi API & SDK](https://docs.cabalspy.xyz/cabalspy-id/overview.md): CabalSpy ID is a SocialFi API and SDK for trading platforms: sign in with X, verified wallets, live trades and PnL on Solana, BNB Chain, Base, Ethereum and Robinhood Chain, token theses and webhooks.
- [SocialFi API quickstart](https://docs.cabalspy.xyz/cabalspy-id/quickstart.md): Integrate the CabalSpy ID SocialFi API in five steps: create an instance, add the login button, verify the ID token and read your users' verified wallets and trading data.
- [Login button](https://docs.cabalspy.xyz/cabalspy-id/login-button.md): Add Sign in with CabalSpy ID to any website with two lines of HTML. The widget runs PKCE for browser apps and shows an account menu once signed in.
- [OpenID Connect](https://docs.cabalspy.xyz/cabalspy-id/openid-connect.md): CabalSpy ID is a standard OpenID Connect provider: authorization code flow with mandatory PKCE, ES256 ID tokens, rotating refresh tokens.
- [Webhooks](https://docs.cabalspy.xyz/cabalspy-id/webhooks.md): Get notified when your users verify or remove a wallet, update their profile, receive the KOL badge or revoke access. Signed with Standard Webhooks.
- [SocialFi Data API — authentication](https://docs.cabalspy.xyz/cabalspy-id/data-api.md): Authenticate to the CabalSpy ID SocialFi Data API: base URL, API keys, instance scope, response envelope, pagination and rate-limit headers.
- [Plans and limits](https://docs.cabalspy.xyz/cabalspy-id/plans.md): CabalSpy ID plans per registrable domain: how many users you receive data for, the API request rate, the live stream and what happens above the limit.
- [Health](https://docs.cabalspy.xyz/cabalspy-id/health.md): GET /v1/health: service health and freshness of the trade data. No API key required.
- [Me](https://docs.cabalspy.xyz/cabalspy-id/me.md): GET /v1/me: the instance your API key works with, its plan, request rate and how many users you receive data for.
- [Users](https://docs.cabalspy.xyz/cabalspy-id/users.md): GET /v1/users: the people who signed in to your platform with CabalSpy ID, newest first, with X profile, KOL badge and verified wallets.
- [Profile](https://docs.cabalspy.xyz/cabalspy-id/profile.md): GET /v1/profile: one CabalSpy ID user by X handle, csid_id (the sub of the ID token) or a verified wallet address.
- [Wallet lookup](https://docs.cabalspy.xyz/cabalspy-id/wallet-lookup.md): GET /v1/wallets/lookup: which of your users verified a wallet, proven by an on-chain payment from it.
- [Tracker](https://docs.cabalspy.xyz/cabalspy-id/tracker.md): GET /v1/wallets/tracker: the full trading profile of a verified wallet for a period: stats, realized PnL, win rate distribution, traded tokens, PnL chart and trades.
- [History](https://docs.cabalspy.xyz/cabalspy-id/history.md): GET /v1/wallets/history: lifetime stats, a per-token overview and the complete paginated trade log of a verified wallet.
- [Holdings](https://docs.cabalspy.xyz/cabalspy-id/holdings.md): GET /v1/wallets/holdings: current token balances of a verified wallet with USD value, read from the chain.
- [PnL calendar](https://docs.cabalspy.xyz/cabalspy-id/pnl-calendar.md): GET /v1/wallets/pnl_calendar: realized PnL per UTC day of a verified wallet, grouped by month, with trade counts and win and loss streaks.
- [Leaderboard](https://docs.cabalspy.xyz/cabalspy-id/leaderboard.md): GET /v1/wallets/leaderboard: your users' verified wallets ranked by volume, PnL, win rate or trades for a period.
- [Latest trades](https://docs.cabalspy.xyz/cabalspy-id/latest.md): GET /v1/transactions/latest: the newest trades of your users' verified wallets, each with the trader's profile.
- [Token theses — SocialFi widget & API](https://docs.cabalspy.xyz/cabalspy-id/theses.md): Token theses: a SocialFi widget and API where only verified holders post opinions on a token, each shown with their real position and PnL, shared across platforms.
- [List theses](https://docs.cabalspy.xyz/cabalspy-id/theses-list.md): GET /v1/theses: the theses of a token, newest or top first, each with the author's real position and PnL.
- [Thesis summary](https://docs.cabalspy.xyz/cabalspy-id/theses-summary.md): GET /v1/theses/summary: number of theses, bull and bear counts and authors for a token, with token name, symbol, logo and price.
- [Get thesis](https://docs.cabalspy.xyz/cabalspy-id/theses-item.md): GET /v1/theses/item: one thesis or reply by id, with author, reactions and the author's position.
- [List replies](https://docs.cabalspy.xyz/cabalspy-id/theses-replies.md): GET /v1/theses/replies: the replies to a thesis, oldest first.
- [Latest theses](https://docs.cabalspy.xyz/cabalspy-id/theses-latest.md): GET /v1/theses/latest: the newest theses across all tokens, from everyone or only from your users.
- [User theses](https://docs.cabalspy.xyz/cabalspy-id/theses-user.md): GET /v1/theses/user: the theses one user wrote, newest first, by csid_id or X handle.
- [Eligibility](https://docs.cabalspy.xyz/cabalspy-id/theses-eligibility.md): GET /v1/theses/eligibility: whether one of your users can post a thesis on a token or reply, before you show the composer.
- [Post thesis](https://docs.cabalspy.xyz/cabalspy-id/theses-post.md): POST /v1/theses: post a thesis on a token in the name of one of your users. Holders only.
- [Post reply](https://docs.cabalspy.xyz/cabalspy-id/theses-reply.md): POST /v1/theses/replies: reply to a thesis in the name of one of your users.
- [React](https://docs.cabalspy.xyz/cabalspy-id/theses-reactions.md): POST /v1/theses/reactions: add or remove a like or emoji reaction in the name of one of your users.
- [Report](https://docs.cabalspy.xyz/cabalspy-id/theses-report.md): POST /v1/theses/report: report a thesis or reply in the name of one of your users.
- [Delete](https://docs.cabalspy.xyz/cabalspy-id/theses-delete.md): POST /v1/theses/delete: delete a thesis or reply in the name of its author.
- [Moderation and appeals](https://docs.cabalspy.xyz/cabalspy-id/theses-moderation.md): How reported theses are hidden, warnings and pauses, moderator decisions, notifications and appeals, and the APIs to show them in your own UI.
- [Theses stream](https://docs.cabalspy.xyz/cabalspy-id/theses-stream.md): wss://api-id.cabalspy.xyz/v1/theses/stream: live theses, replies, reactions and removals for the tokens you subscribe to. Every plan.
- [Browser API](https://docs.cabalspy.xyz/cabalspy-id/theses-browser-api.md): The public thesis API on id.cabalspy.xyz for client-side apps: every call carries your instance's public client_id; public reads, writes with the user's access token (scope thesis) and a public live websocket per token.
- [Live stream](https://docs.cabalspy.xyz/cabalspy-id/stream.md): wss://api-id.cabalspy.xyz/v1/stream: every trade of your users' verified wallets and every new thesis, reply, reaction and removal, pushed live over a WebSocket. Pro plan and up.
- [Errors](https://docs.cabalspy.xyz/cabalspy-id/errors.md): Every error code of the CabalSpy ID Data API, the thesis browser API and the streams, what it means and how to fix it.
- [SocialFi SDK for JavaScript, React and Python](https://docs.cabalspy.xyz/cabalspy-id/sdks.md): Official CabalSpy ID SocialFi SDK for JavaScript/TypeScript, React and Python: login with OpenID Connect, Data API client, live streams, token theses and webhook verification.
- [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.
- [Thesis Markers on Your Price Chart](https://docs.cabalspy.xyz/thesis-markers-on-price-chart.md): Put token theses from verified holders on your price chart as live markers, colored by bull or bear, labelled with the author and their real PnL. Plain JavaScript with TradingView Lightweight Charts and a tiny Node relay.


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