# CabalSpy

> CabalSpy is a KOL API and Smart Money API: a multi-chain data API for labeled crypto wallets. It tracks 5,500+ KOL (Key Opinion Leader), Smart Money and Whale wallets on Solana, BNB Chain, Base, Ethereum and Robinhood Chain and delivers their trades, holdings, PnL and live signals via REST API, WebSocket streams and a drop-in widget. Used by trading terminals such as Axiom, Trojan and o1.exchange.

Key facts:
- Chains: Solana (1,100+ KOL, 950+ Smart Money, Whales), BNB Chain (1,400+ KOL, 600+ Smart Money), Base (1,400+ KOL, 100+ Smart Money), Ethereum (1,400+ KOL, 600+ Smart Money), Robinhood Chain (1,400+ KOL, 600+ Smart Money)
- REST API: 30+ endpoints, base URL https://api.cabalspy.xyz/v1/ — auth via api_key query parameter or "Authorization: Bearer <key>"
- WebSocket: wss://stream.cabalspy.xyz — 6 streams (tx, count, holder, balance, signal, bundle) over one connection
- Pricing: Free $0 (10,000 credits/month), Starter $49/mo, Pro $249/mo, Business $499/mo, Enterprise custom. REST request = 10 credits, WebSocket event = 1 credit. Yearly billing saves 20%.
- Free API key: https://apidashboard.cabalspy.xyz/register (no credit card)
- Uptime SLA: 99.90%; median WebSocket latency 24ms

## Product

- [KOL API overview](https://www.cabalspy.xyz/kol-api/): What a KOL API is, data coverage, endpoints, WebSocket streams, code examples, pricing and FAQ
- [Smart Money API](https://www.cabalspy.xyz/smart-money-api/): Smart Money wallets (proven on-chain traders selected by win rate and ROI consistency), how they differ from KOL wallets, endpoints with type=smart, code examples and FAQ
- [MCP Server](https://www.cabalspy.xyz/mcp/): Remote MCP server (https://mcp.cabalspy.xyz/mcp, Streamable HTTP, 29 read-only tools) that connects Claude, Cursor, VS Code and other AI clients to CabalSpy wallet data and CabalSpy ID (SocialFi). Auth: X-CabalSpy-Key header or ?api_key= on the URL; without a key the tools run on the public demo. Source: https://github.com/CabalSpy/CabalSpy-MCP-Server
- MCP tools for CabalSpy ID: csid_profile (verified trader identity by X handle, CSID id or wallet), csid_wallet_owner (who verified a wallet, 1-100 addresses), csid_kols (badge-verified KOLs per chain), csid_token_theses (holder sentiment: bull/bear summary and theses with the author's live position and PnL), csid_latest_theses, csid_user_theses, csid_thesis (with replies), csid_leaderboard (your instance's verified traders). Identity tools work on the keyless demo with sandbox identities; theses and the leaderboard need an API key with a CabalSpy ID instance (https://apidashboard.cabalspy.xyz/csid). Example prompts: "What do verified holders think about $BONK?", "Who owns wallet <address>?", "Is @handle a verified trader?"
- [SDKs](https://www.cabalspy.xyz/sdks/): Official SDKs — TypeScript (npm install cabalspy), Python (pip install cabalspy), Rust (crate cabalspy). Source: https://github.com/CabalSpy
- [x402 for AI agents](https://www.cabalspy.xyz/x402/): Pay per request in USDC on Solana, Base, Polygon or Arbitrum — no account or API key. Clients: npm install cabalspy-x402, pip install "cabalspy-x402[all]". Spend limits on by default ($0.10 per call, $10 total).
- [Solana KOL API](https://www.cabalspy.xyz/solana-kol-api/): Solana KOL, Smart Money and Whale wallets, KOL holders per token, bundle detection, code examples
- [KOL wallets](https://www.cabalspy.xyz/kol/): Directory of every tracked KOL with wallet addresses, X profile and 30-day PnL, win rate and trades. One page per KOL at https://www.cabalspy.xyz/kol/<x-handle>/
- [Pricing](https://www.cabalspy.xyz/pricing/): Plans, credits, rate limits, widget pricing and CabalSpy ID plans
- [CabalSpy ID](https://www.cabalspy.xyz/cabalspy-id/): The SocialFi layer for any platform or app (trading terminals, DEXs, launchpads, bots, wallets, games, communities). "Login with CabalSpy ID" (OpenID Connect) gives a platform each user's X profile, verified wallets and every trade they make, live on Solana, BNB, Base, Ethereum and Robinhood Chain, via Data API, WebSocket stream and webhooks. Use cases: leaderboards, token theses, trades on the chart, live feeds, copy trading, trader profiles. Plans: https://www.cabalspy.xyz/pricing/#cabalspy-id. Docs: https://docs.cabalspy.xyz/cabalspy-id
- [SocialFi API](https://www.cabalspy.xyz/socialfi-api/): CabalSpy ID as SocialFi API and SDK — X login (OpenID Connect), verified wallets, live trades, token theses widget; REST, WebSocket, webhooks; SDKs: npm install cabalspy-id, pip install cabalspy-id
- [Home](https://www.cabalspy.xyz/): Product overview for trading terminals, copy-trading apps, bots and AI agents
- [CabalSpy Terminal](https://app.cabalspy.xyz/): CabalSpy's own trading terminal — trade tokens with KOL and Smart Money data built in. Token page: https://app.cabalspy.xyz/token/<mint address>

## Use cases

- [KOL Chart Events](https://www.cabalspy.xyz/use-cases/kol-chart-events/): Plot KOL, Smart Money and Whale trades as buy/sell markers on your token charts. Live WebSocket stream for TradingView and custom charts.
- [KOL Leaderboard](https://www.cabalspy.xyz/use-cases/kol-leaderboard/): Build a KOL leaderboard like Axiom Vision: rank KOL, Smart Money and Whale wallets by PnL, win rate, trades or volume with one endpoint. Free tier.
- [KOL Wallet Tracking](https://www.cabalspy.xyz/use-cases/kol-wallet-tracking/): Turn any tracked KOL or Smart Money wallet into a full profile: realized PnL, win rate, traded tokens, live holdings and trade history. Build a wallet tracker like Axiom.
- [KOL Holders Table](https://www.cabalspy.xyz/use-cases/kol-holders-table/): Power the holders tab in your trading terminal: which KOLs and Smart Money wallets hold a token, their position, entry and unrealized PnL — live.
- [KOL Signal Service](https://www.cabalspy.xyz/use-cases/kol-signals/): Get entry and exit signals when clusters of KOL or Smart Money wallets buy the same token. REST and WebSocket for Telegram bots, alpha bots and AI agents.
- [KOL Wallet Count](https://www.cabalspy.xyz/use-cases/kol-wallet-count/): Show how many KOL, Smart Money or Whale wallets are in a token right now. REST for on-demand counts, WebSocket for live badges.
- [KOL Supply Holding](https://www.cabalspy.xyz/use-cases/kol-supply-holding/): Show what share of a token's supply KOL, Smart Money and Whale wallets hold, and how much of their bag is left — updated live from the trade stream.
- [KOL Widget](https://www.cabalspy.xyz/use-cases/kol-widget/): Embed a live widget in your trading terminal or website that shows how many KOL and Smart Money wallets are in any token — one iframe, five chains.
- [KOL Bundle Detection](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/): Detect coordinated bundles where a KOL and side wallets buy a Solana token in the same block, with confidence score and proof. REST and WebSocket.
- [PnL Calendar](https://www.cabalspy.xyz/use-cases/pnl-calendar/): A month-by-month calendar of a KOL or Smart Money wallet’s realized PnL, one cell per day, with volume, trade counts and streaks. One API call.
- [KOL Data Layer](https://www.cabalspy.xyz/use-cases/kol-data-analytics/): Aggregate KOL and Smart Money data via REST and WebSocket: total volume, trade counts per time window, most-traded tokens and historical data since February 2025.
- [SocialFi Layer](https://www.cabalspy.xyz/use-cases/socialfi-layer/): Add a SocialFi layer to any app with CabalSpy ID: one login gives you verified wallets and every trade of your users, live on 5 chains. Build leaderboards, feeds and copy trading.
- [Token Theses](https://www.cabalspy.xyz/use-cases/token-theses/): Add token theses to your app: holders explain why they hold, every thesis shows their real on-chain position and live PnL. Widget or API, live theses stream, moderation included.

## Documentation

- [API documentation](https://docs.cabalspy.xyz/): Full REST and WebSocket reference
- [Documentation index for LLMs](https://docs.cabalspy.xyz/llms.txt): Machine-readable index of every docs page
- [Full API reference for LLMs](https://docs.cabalspy.xyz/llms-full.txt): Every docs page in one file

## For AI agents

- [llms-full.txt](https://www.cabalspy.xyz/llms-full.txt): Full text of the main pages of this site in one Markdown file
- [OpenAPI specification](https://www.cabalspy.xyz/openapi.json): OpenAPI 3.1 description of the REST API, importable into agent frameworks and API clients
- [MCP server card](https://www.cabalspy.xyz/.well-known/mcp.json): MCP endpoint, authentication and the list of tools
- [Service status](https://status.cabalspy.xyz/): Live status, 30-day uptime and incidents per service. JSON: https://status.cabalspy.xyz/status

## Comparisons

- [CabalSpy vs Alchemy](https://www.cabalspy.xyz/vs/alchemy/): Alchemy is blockchain infrastructure across 100+ chains — it has no KOL, Smart Money or Whale wallet label layer. CabalSpy is the specialised KOL wallet API that adds it: REST, WebSocket and widget on Solana, BNB, Base, Ethereum and Robinhood Chain.
- [CabalSpy vs Moralis](https://www.cabalspy.xyz/vs/moralis/): Moralis is a broad Web3 data API whose address labels cover exchanges and protocols, not crypto influencers. CabalSpy is the specialised KOL wallet API with Twitter-verified labeled wallets, REST and WebSocket across five chains.
- [CabalSpy vs Helius](https://www.cabalspy.xyz/vs/helius/): Helius is the leading Solana RPC and data API — it has no curated KOL wallet label database. CabalSpy is the KOL intelligence layer that runs on top of Solana infrastructure, with verified influencer wallets, win rates and live WebSocket feeds.
- [CabalSpy vs Nansen](https://www.cabalspy.xyz/vs/nansen/): Nansen Smart Money labels are behavioural — they identify wallets by on-chain PnL patterns. CabalSpy labels are identity-based, linking verified Twitter crypto influencers to their wallets, with REST and WebSocket access for trading terminals.
- [CabalSpy vs Birdeye](https://www.cabalspy.xyz/vs/birdeye/): Birdeye has strong Solana token analytics and a Wallet PnL API, but no curated KOL, Smart Money or Whale label database. CabalSpy is the specialised KOL wallet API with Twitter-verified labeled wallets and live WebSocket feeds.
- [CabalSpy vs GMGN](https://www.cabalspy.xyz/vs/gmgn/): GMGN is a meme trading terminal with KOL tracking and a trade-execution-focused API. CabalSpy is a purpose-built B2B KOL data API with a published SLA, redistribution rights and stable WebSocket feeds for embedded products.
- [CabalSpy vs Mobula](https://www.cabalspy.xyz/vs/mobula/): Mobula is a real-time DeFi data API covering prices, OHLCV and wallet PnL — with no curated KOL identity database. CabalSpy adds the identity and social graph layer on top of wallet data.
- [CabalSpy vs Solana Tracker](https://www.cabalspy.xyz/vs/solana-tracker/): Solana Tracker offers broad Solana token analytics across all tokens and wallets. CabalSpy is narrow and deep: verified Solana wallets mapped to real crypto KOL identities with proven track records.
- [CabalSpy vs Codex](https://www.cabalspy.xyz/vs/codex/): Codex indexes 700M+ wallets across 80+ chains with market-leading token price and OHLCV data — but no KOL, Smart Money or Whale label layer. CabalSpy is the KOL intelligence overlay that trading terminals run alongside it.
- [CabalSpy vs KOLSCAN](https://www.cabalspy.xyz/vs/kolscan/): KOLSCAN is a free Solana consumer tracker with no developer API. CabalSpy is the production KOL wallet API — REST endpoints, WebSocket streams and a drop-in widget across Solana, BNB Chain, Base and Ethereum.

## FAQ

### What is CabalSpy?
CabalSpy is a KOL API and Smart Money API: a multi-chain data API for labeled wallets. It tracks 5,500+ KOL, Smart Money and Whale wallets on Solana, BNB Chain, Base, Ethereum and Robinhood Chain and delivers their trades, holdings and PnL via REST API, WebSocket streams and a drop-in widget.

### What is a KOL API?
A KOL API gives developers programmatic access to the on-chain activity of Key Opinion Leaders — crypto influencers whose wallets are publicly linked to their identity. With the CabalSpy KOL API you can list tracked KOL wallets, see which KOLs hold or trade a token, stream their buys and sells in real time and rank them by PnL and win rate.

### What is a Smart Money wallet?
A Smart Money wallet belongs to a high-skill trader identified by historical win rate, ROI consistency and edge across multiple market cycles — selected by on-chain track record rather than public following. CabalSpy tracks 2,900+ Smart Money wallets on Solana, BNB Chain, Base, Ethereum and Robinhood Chain, available through the same endpoints as KOL wallets with type=smart.

### Which blockchains does CabalSpy support?
Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana has the deepest coverage with 1,100+ KOL and 950+ Smart Money wallets, plus Whale wallets. One unified schema covers all chains, so you integrate once.

### How are wallets labeled?
We combine on-chain activity analysis, our KOL connections network and verified doxxed wallets. KOLs apply through CabalSpy ID with verified wallets. Minimum to apply: 5,000+ X followers, an X account older than 90 days and $25k+ trading volume in the last 7 days; we look for around $100k+ weekly volume. Every application is reviewed manually, and every label is verified before it reaches the API.

### Does CabalSpy provide real-time data?
Yes. Next to the REST API, CabalSpy offers WebSocket streams over a single connection: transactions, KOL wallet count per token, token holders, wallet balances, cluster buy/sell signals and KOL bundle detection. Events are pushed the moment tracked wallets trade.

### How do I get an API key?
Create a free account at apidashboard.cabalspy.xyz and copy your key from the dashboard — no credit card required. Authenticate with the api_key query parameter or an Authorization: Bearer header. The free tier includes 10,000 credits per month; a REST request costs 10 credits and a WebSocket event 1 credit.

### How much does CabalSpy cost?
The Free plan is $0 with 10,000 credits per month. Paid plans start at $49/month (Starter, 100,000 credits), followed by Pro ($249/month, 1,000,000 credits) and Business ($499/month, 2,000,000 credits). Yearly billing saves 20%. Enterprise plans add custom throughput and SLA-backed uptime.

### Who uses CabalSpy?
Trading terminals like Axiom, Trojan and o1.exchange, copy-trading apps, alpha bots, AI trading agents, analytics dashboards, on-chain analysts and law enforcement teams — 20+ integration partners in total.

### Can I submit my wallet to be labeled?
Yes — wallets are now added through CabalSpy ID. Sign in with X, verify your wallets with a tiny on-chain payment (no wallet connect) and apply for the KOL badge at id.cabalspy.xyz/me/kol. Minimum to apply: 5,000+ X followers, an X account older than 90 days and $25k+ trading volume in the last 7 days on verified wallets. We look for around $100k+ weekly volume. Every application is reviewed manually — meeting the minimum doesn’t guarantee approval.

## Optional

- [Apply as KOL](https://id.cabalspy.xyz/me/kol): Traders get labeled by verifying their wallets with CabalSpy ID and applying for the KOL badge. Minimum: 5,000+ X followers, X account older than 90 days, $25k+ trading volume in the last 7 days; around $100k+ weekly volume preferred; every application reviewed manually
- [Legal notice](https://www.cabalspy.xyz/imprint/)
- [Privacy policy](https://www.cabalspy.xyz/privacy/)
- [X / Twitter](https://x.com/CabalSpySol)
- [Telegram](https://t.me/CabalSpyPortal)
- [Discord](https://discord.gg/YgTPeZ2UYc)