# 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 " - 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 This file is the full text of the main pages of https://www.cabalspy.xyz in one document. Short index: https://www.cabalspy.xyz/llms.txt. API reference in full: https://docs.cabalspy.xyz/llms-full.txt. OpenAPI: https://www.cabalspy.xyz/openapi.json. MCP server card: https://www.cabalspy.xyz/.well-known/mcp.json. Live status: https://status.cabalspy.xyz/ (JSON: https://status.cabalspy.xyz/status). --- ## Frequently asked questions ### 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. --- ## KOL API — Real-time KOL Wallet Data for Developers | CabalSpy URL: https://www.cabalspy.xyz/kol-api/ > The CabalSpy KOL API delivers labeled KOL, Smart Money & Whale wallets, their trades, holdings and PnL via REST and WebSocket on Solana, BNB, Base, Ethereum & Robinhood Chain. Free tier. ### KOL API — real-time KOL wallet data The CabalSpy **KOL API** gives your product 5,500+ labeled KOL, Smart Money and Whale wallets — their trades, holdings, PnL and live signals — via REST and WebSocket on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Developer Guide · KOL API #### Everything you need to know about the CabalSpy KOL API #### What is a KOL API? KOLs — Key Opinion Leaders — are crypto traders and influencers with a public following whose wallets are known. When several of them buy the same token, markets move. A **KOL API** turns that activity into data your product can use: which wallets belong to which KOL, what they trade, what they hold and how profitable they are. CabalSpy maintains a verified database of 5,500+ labeled wallets — browse them in the [KOL wallet directory](https://www.cabalspy.xyz/kol/). Every wallet carries a public profile — name, avatar, X/Twitter and Telegram links — and is enriched with realized PnL, win rate and position data. You integrate once and get the same schema on every chain. #### What data does the KOL API provide? The REST API covers 30+ endpoints across three areas: - **Wallets** — list all tracked KOL, Smart Money and Whale wallets per chain, look up any address, rank wallets on a leaderboard by PnL, win rate, trades or volume, and find connected wallets. - **Wallet tracking** — full trading profile per wallet: period stats, realized PnL chart, PnL calendar, lifetime history, active holdings and recent trades. - **Tokens** — which tracked wallets hold a token (with position, unrealized PnL and entry market cap), their buy and sell transactions, aggregate token stats, volume and trade counts, cluster signals and KOL bundle detection. #### Real-time KOL streams For live products, 6 WebSocket streams run over a single connection. You subscribe with small JSON messages and receive events the moment tracked wallets trade: - `tx` — every KOL, Smart Money and Whale buy and sell with the running position - `count` — live number of KOL wallets in a token - `holder` — all tracked holders of a token with position and unrealized PnL - `balance` — native balance of tracked wallets, updated on every trade - `signal` — entry and exit alerts when clusters of KOLs buy or sell together - `bundle` — coordinated KOL bundles: side wallets buying alongside a KOL #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register), then fetch every KOL wallet on Solana: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/wallets?blockchain=solana&type=kol&limit=50" \ -H "Authorization: Bearer YOUR_KEY" ``` REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", type: "kol", limit: "50" }); const res = await fetch(`https://api.cabalspy.xyz/v1/wallets?${p}`, { headers: { Authorization: "Bearer YOUR_KEY" }, }); const { data } = await res.json(); data.wallets.forEach(w => console.log(w.name || w.wallet_address, "->", w.twitter)); ``` Prefer a typed client? Official [SDKs for TypeScript, Python and Rust](https://www.cabalspy.xyz/sdks/) are available, and AI agents can pay per request via [x402](https://www.cabalspy.xyz/x402/) without an API key. Stream every KOL trade in real time: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { // every KOL buy and sell on Solana, live ws.send(JSON.stringify({ op: "subscribe", stream: "tx", blockchain: "solana", type: "kol", token: "*", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); console.log(msg.event, msg.data); }; ``` #### Chains and coverage | Chain | KOL wallets | Smart Money | Whales | | --- | --- | --- | --- | | Solana | 1,100+ | 950+ | Yes | | BNB Chain | 1,400+ | 600+ | — | | Base | 1,400+ | 100+ | — | | Ethereum | 1,400+ | 600+ | — | | Robinhood Chain | 1,400+ | 600+ | — | Looking for Solana specifically? See the [Solana KOL API](https://www.cabalspy.xyz/solana-kol-api/) guide. For wallets selected by track record rather than following, see the [Smart Money API](https://www.cabalspy.xyz/smart-money-api/). #### What teams build with it - **Trading terminals** — a KOL holders tab on every token page, KOL buy/sell bubbles on the chart - **Copy-trading apps** — leaderboards of verified KOLs ranked by win rate and PnL - **Alpha and Telegram bots** — alerts when several KOLs enter the same token - **AI trading agents** — check whether a wallet is a tracked KOL before weighting a signal, via the API or the [MCP server](https://www.cabalspy.xyz/mcp/) - **Analytics dashboards and analysts** — wallet profiles, PnL calendars and connection graphs Each of these has its own guide with endpoints and code — see all [KOL API use cases](https://www.cabalspy.xyz/use-cases/), for example [chart events](https://www.cabalspy.xyz/use-cases/kol-chart-events/), the [KOL leaderboard](https://www.cabalspy.xyz/use-cases/kol-leaderboard/), [signals](https://www.cabalspy.xyz/use-cases/kol-signals/) and the [embeddable widget](https://www.cabalspy.xyz/use-cases/kol-widget/). #### Pricing Every plan includes REST and WebSocket access on all chains. A REST request costs 10 credits, a WebSocket event 1 credit. | Plan | Price | Credits / month | Requests / sec | | --- | --- | --- | --- | | Free | $0 | 10,000 | 5 | | Starter | $49/mo | 100,000 | 20 | | Pro | $249/mo | 1,000,000 | 50 | | Business | $499/mo | 2,000,000 | 100 | Yearly billing saves 20%. Full details on the [pricing page](https://www.cabalspy.xyz/pricing/). #### Frequently asked questions 01 ##### What is a KOL API? A KOL API gives developers programmatic access to the wallets and trades of Key Opinion Leaders — crypto influencers whose on-chain wallets are publicly linked to their identity. Instead of scraping trackers, your product queries labeled KOL wallets, their trades, holdings and PnL through REST endpoints and real-time WebSocket streams. 02 ##### Which chains does the CabalSpy KOL API cover? 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. All chains share one unified response schema. 03 ##### Is there a free KOL API? Yes. The CabalSpy free tier includes 10,000 credits per month (1,000 REST requests, as each request costs 10 credits), full REST and WebSocket access, all chains and all wallet categories — no credit card required. 04 ##### How do I authenticate? Create a free account at apidashboard.cabalspy.xyz, copy your API key and pass it as the api_key query parameter or as an Authorization: Bearer header. WebSocket connections take the key as apiKey query parameter or Bearer header. 05 ##### Can I show CabalSpy KOL data inside my own product? Yes — that is what the API is built for. Trading terminals such as Axiom, Trojan and o1.exchange display CabalSpy KOL labels to their users. If you do not want to build UI, the drop-in widget renders a live KOL bubble map with one iframe. 06 ##### How fast is the real-time data? KOL trades are pushed over WebSocket the moment they happen, with a median latency of 24ms from on-chain event to your connection. One connection can subscribe to all six streams. #### How CabalSpy compares [vs KOLSCAN](https://www.cabalspy.xyz/vs/kolscan/)[vs GMGN](https://www.cabalspy.xyz/vs/gmgn/)[vs Nansen](https://www.cabalspy.xyz/vs/nansen/)[vs Birdeye](https://www.cabalspy.xyz/vs/birdeye/)[vs Helius](https://www.cabalspy.xyz/vs/helius/)[vs Codex](https://www.cabalspy.xyz/vs/codex/) #### Ship KOL data this afternoon. Free API key, no credit card. 10,000 free credits every month, REST and WebSocket on all five chains, 99.90% uptime SLA on paid plans. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Solana KOL API — Track Solana KOL Wallets in Real Time | CabalSpy URL: https://www.cabalspy.xyz/solana-kol-api/ > Solana KOL API with 1,100+ labeled KOL wallets, 950+ Smart Money wallets and Whales: trades, holders, PnL, bundle detection and live WebSocket streams. Free tier available. ### Solana KOL API — track 1,100+ Solana KOLs live Labeled Solana KOL, Smart Money and Whale wallets with trades, holders, realized PnL, bundle detection and real-time WebSocket streams — the **Solana KOL API** behind trading terminals like Axiom and Trojan. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Developer Guide · Solana #### The most complete Solana KOL wallet dataset, as an API #### Why a Solana KOL API? On Solana, memecoin momentum is driven by a few hundred traders with large followings. When they buy, their followers copy them within seconds. Knowing which wallets belong to those KOLs — and seeing their trades as they happen — is the edge trading terminals, copy-trading apps and alpha bots compete on. CabalSpy tracks **1,100+ Solana KOL wallets**, **950+ Smart Money wallets** and Solana Whales. Each wallet is verified and linked to its public identity, so you can label wallets across your product without maintaining the list yourself. #### What you get on Solana - **All three wallet categories** — Solana is the only chain with KOL, Smart Money and Whale wallets. - **KOL holders per token** — every tracked holder of a mint with position, unrealized PnL and entry market cap. - **KOL bundle detection** — side wallets buying in the same block alongside a KOL, with a confidence score and proof. - **Cluster signals** — alerts when several KOLs buy the same token within a time window, plus historical signals for backtesting. - **Wallet profiles** — realized PnL, win rate, PnL calendar, lifetime history and current holdings for any KOL. - **Leaderboards** — rank Solana KOLs by PnL, win rate, trades or volume for any period. #### Get every Solana KOL wallet REST · cURL ``` curl "https://api.cabalspy.xyz/v1/wallets?blockchain=solana&type=kol&api_key=YOUR_KEY" ``` REST · Python ``` import requests params = {"blockchain": "solana", "type": "kol", "limit": 50, "api_key": "YOUR_KEY"} r = requests.get("https://api.cabalspy.xyz/v1/wallets", params=params) for w in r.json()["data"]["wallets"]: print(w["name"] or w["wallet_address"], "->", w["twitter"]) ``` #### Stream Solana KOL trades in real time One WebSocket connection, any number of subscriptions. Follow a single token's KOL holders or every KOL trade on Solana: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { // live KOL holders of one Solana token ws.send(JSON.stringify({ op: "subscribe", stream: "holder", token: "TOKEN_MINT" })); // every Solana KOL trade ws.send(JSON.stringify({ op: "subscribe", stream: "tx", blockchain: "solana", type: "kol", token: "*", })); }; ws.onmessage = (e) => console.log(JSON.parse(e.data)); ``` #### Built for Solana trading products - **Trading terminals** — a "KOL holders" tab and KOL buy/sell markers on every token chart - **Copy-trading** — follow the best Solana KOLs ranked by verified PnL - **Telegram alpha bots** — fire when several KOLs enter a fresh token - **Risk tools** — flag KOL bundles and coordinated buying before users ape in Step-by-step guides: [KOL holders table](https://www.cabalspy.xyz/use-cases/kol-holders-table/), [bundle detection](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/), [chart events](https://www.cabalspy.xyz/use-cases/kol-chart-events/) and [all use cases](https://www.cabalspy.xyz/use-cases/). Beyond Solana, the same API covers BNB Chain, Base, Ethereum and Robinhood Chain — see the [KOL API overview](https://www.cabalspy.xyz/kol-api/), the [Smart Money API](https://www.cabalspy.xyz/smart-money-api/) and [pricing](https://www.cabalspy.xyz/pricing/). #### Frequently asked questions 01 ##### What is the Solana KOL API? The CabalSpy Solana KOL API is a REST and WebSocket API for 1,100+ labeled Solana KOL wallets, 950+ Smart Money wallets and tracked Whales. It returns each wallet's public profile, trades, holdings, realized PnL and win rate, and streams every buy and sell in real time. 02 ##### How do I get all Solana KOL wallets? Call GET https://api.cabalspy.xyz/v1/wallets?blockchain=solana&type=kol with your API key. Without a limit you get every tracked Solana KOL wallet in one response, each with name, avatar, X/Twitter, Telegram and copytrade link. Use type=smart or type=whale for the other categories. 03 ##### Can I see which KOLs hold a Solana token? Yes. The token holders endpoint returns every tracked wallet holding a token, ranked by amount, with live position, unrealized PnL, remaining value and entry market cap. The holder WebSocket stream keeps that list updated in real time. 04 ##### What is KOL bundle detection? On Solana, CabalSpy detects coordinated bundles: side wallets that buy a token in the same block alongside a KOL. The bundle endpoint and bundle stream return the KOL, the side wallets, a confidence score, proof and live positions. 05 ##### Is the Solana KOL API free? There is a free tier with 10,000 credits per month (1,000 REST requests) including WebSocket access — no credit card. Paid plans start at $49/month. 06 ##### Which Solana trading terminals use CabalSpy? CabalSpy powers labeled-wallet data inside Solana trading tools such as Axiom and Trojan, plus copy-trading apps, alpha bots and analytics dashboards. #### Compare Solana data providers [vs KOLSCAN](https://www.cabalspy.xyz/vs/kolscan/)[vs GMGN](https://www.cabalspy.xyz/vs/gmgn/)[vs Birdeye](https://www.cabalspy.xyz/vs/birdeye/)[vs Helius](https://www.cabalspy.xyz/vs/helius/)[vs Solana Tracker](https://www.cabalspy.xyz/vs/solana-tracker/)[vs Nansen](https://www.cabalspy.xyz/vs/nansen/) #### Track Solana KOLs in your product. Start free today. 10,000 free credits every month, REST and WebSocket, no credit card. Plans from $49/month. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Smart Money API — Track Smart Money Wallets in Real Time | CabalSpy URL: https://www.cabalspy.xyz/smart-money-api/ > Smart Money API with 2,900+ labeled Smart Money wallets on Solana, BNB, Base, Ethereum and Robinhood Chain: trades, holdings, PnL, leaderboards and live WebSocket signals. Free tier. ### Smart Money API — follow the wallets that win The CabalSpy **Smart Money API** gives your product 2,900+ labeled Smart Money wallets — proven on-chain traders, their trades, holdings and PnL — via REST and WebSocket on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Developer Guide · Smart Money API #### Smart Money wallets, labeled and ready to query #### What is Smart Money? "Smart Money" describes wallets that are consistently right: traders who enter early, exit well and stay profitable across market cycles. Following them is one of the oldest edges in on-chain trading — the hard part is knowing which wallets qualify. CabalSpy labels a wallet as **Smart Money** when it belongs to a high-skill trader identified by historical win rate, ROI consistency and edge across multiple market cycles. The **Smart Money API** exposes that list — 2,900+ wallets — together with every trade those wallets make. #### Smart Money vs KOL wallets | | Smart Money | KOL | | --- | --- | --- | | Selected by | On-chain track record: win rate, ROI consistency | Public identity and following | | Signal | What proven traders buy | What influential traders buy — and what their followers copy | | API value | `type=smart` | `type=kol` | Both categories share the same endpoints, streams and response schema, so you can show them side by side — for example as two columns in a holders tab. Need influencer wallets? See the [KOL API](https://www.cabalspy.xyz/kol-api/). #### What the Smart Money API provides - **Wallet list** — every tracked Smart Money wallet per chain with name, avatar, socials and copytrade link. - **Leaderboard** — Smart Money wallets ranked by PnL, win rate, trades or volume for 6 hours, 1 day, 7 days or 30 days. - **Wallet profiles** — realized PnL, win rate, traded tokens, live holdings, lifetime history and a PnL calendar per wallet. - **Token view** — which Smart Money wallets hold a token, their position and their buys and sells. - **Signals** — alerts when a cluster of Smart Money wallets buys the same token within a time window. - **Real-time streams** — every Smart Money buy and sell pushed over WebSocket the moment it happens. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register), then list every Smart Money wallet on Solana: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/wallets?blockchain=solana&type=smart&limit=50" \ -H "Authorization: Bearer YOUR_KEY" ``` Rank them by performance over the last 7 days: REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", type: "smart", period: "7d", limit: "20", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/wallets/leaderboard?${p}`); const { data } = await res.json(); data.leaderboard.forEach((w, i) => console.log(`${i + 1}. ${w.profile.name || w.wallet} vol ${w.period_stats.total_volume}`)); ``` Stream every Smart Money trade in real time: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { // every Smart Money buy and sell on Solana, live ws.send(JSON.stringify({ op: "subscribe", stream: "tx", blockchain: "solana", type: "smart", token: "*", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); console.log(msg.event, msg.data); }; ``` #### Chains and coverage | Chain | Smart Money wallets | `blockchain` value | | --- | --- | --- | | Solana | 950+ | `solana` | | BNB Chain | 600+ | `bnb` | | Robinhood Chain | 600+ | `rh` | | Base | 100+ | `base` | | Ethereum | 600+ | `eth` | On Solana, the same API also covers Whale wallets (`type=whale`). #### What teams build with it - **Trading terminals** — a Smart Money column in the [holders table](https://www.cabalspy.xyz/use-cases/kol-holders-table/) and buy/sell [markers on the chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/) - **Copy-trading apps** — a [leaderboard](https://www.cabalspy.xyz/use-cases/kol-leaderboard/) of proven wallets to follow - **Alert and alpha bots** — [signals](https://www.cabalspy.xyz/use-cases/kol-signals/) when Smart Money clusters into a token - **AI trading agents** — check whether a wallet is tracked Smart Money before weighting its trade - **Token pages** — a live [wallet count](https://www.cabalspy.xyz/use-cases/kol-wallet-count/) and [supply share](https://www.cabalspy.xyz/use-cases/kol-supply-holding/) held by Smart Money See all [use cases](https://www.cabalspy.xyz/use-cases/) and [pricing](https://www.cabalspy.xyz/pricing/). #### Frequently asked questions 01 ##### What is a Smart Money API? A Smart Money API gives developers programmatic access to the wallets of consistently profitable on-chain traders. Instead of guessing which wallets are worth following, your product queries a labeled list of Smart Money wallets, their trades, holdings and PnL through REST endpoints and real-time WebSocket streams. 02 ##### What is a Smart Money wallet? CabalSpy labels a wallet as Smart Money when it belongs to a high-skill trader identified by historical win rate, ROI consistency and edge across multiple market cycles. Unlike KOL wallets, Smart Money wallets are defined by on-chain performance rather than by a public following. 03 ##### What is the difference between KOL wallets and Smart Money wallets? KOL wallets belong to crypto influencers with a public audience and a known identity. Smart Money wallets belong to traders selected for their on-chain track record. CabalSpy tracks both: use type=kol or type=smart on the same endpoints and streams. 04 ##### Which chains have Smart Money wallets? Solana (950+ wallets), BNB Chain, Base, Ethereum and Robinhood Chain — 2,900+ Smart Money wallets in total. 05 ##### How do I get all Smart Money wallets? Call GET https://api.cabalspy.xyz/v1/wallets?blockchain=solana&type=smart with your API key. Without a limit you receive every tracked Smart Money wallet for that chain in one response, each with name, avatar, socials and copytrade link. 06 ##### Can I get alerts when Smart Money buys a token? Yes. Subscribe to the transactions stream with type "smart" to receive every Smart Money buy and sell in real time, or use the signal stream to be alerted when a cluster of Smart Money wallets buys the same token within a time window. 07 ##### Is there a free Smart Money API? Yes. The CabalSpy free tier includes 10,000 credits per month (1,000 REST requests), REST and WebSocket access and all wallet categories — no credit card required. Paid plans start at $49/month. #### How CabalSpy compares [vs Nansen](https://www.cabalspy.xyz/vs/nansen/)[vs GMGN](https://www.cabalspy.xyz/vs/gmgn/)[vs Birdeye](https://www.cabalspy.xyz/vs/birdeye/)[vs KOLSCAN](https://www.cabalspy.xyz/vs/kolscan/)[KOL API](https://www.cabalspy.xyz/kol-api/)[Solana KOL API](https://www.cabalspy.xyz/solana-kol-api/) #### Put Smart Money data in your product. Free API key, no credit card. 10,000 free credits every month, REST and WebSocket access, 99.90% uptime SLA on paid plans. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## CabalSpy MCP Server — KOL & Smart Money Data for Claude, Cursor & AI Agents URL: https://www.cabalspy.xyz/mcp/ > Connect Claude, Cursor, VS Code or ChatGPT to live KOL and Smart Money wallet data. Remote MCP server with 29 read-only tools on 5 chains. Free API key. ### MCP Server — KOL data for your AI agent The **CabalSpy MCP server** gives Claude, Cursor, VS Code and other AI clients live access to labeled KOL, Smart Money and Whale wallets: who is buying what, who is still holding, and whether a launch was bundled. 29 read-only tools, one URL, no install. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cabalspy&config=eyJ1cmwiOiJodHRwczovL21jcC5jYWJhbHNweS54eXovbWNwIiwiaGVhZGVycyI6eyJYLUNhYmFsU3B5LUtleSI6IllPVVJfS0VZIn19)[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22cabalspy%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cabalspy.xyz%2Fmcp%22%2C%22headers%22%3A%7B%22X-CabalSpy-Key%22%3A%22YOUR_KEY%22%7D%7D) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Model Context Protocol · Remote Server #### Ask your AI assistant what KOLs are buying #### What it does The Model Context Protocol (MCP) lets AI assistants call external tools. The **CabalSpy MCP server** exposes the CabalSpy KOL and Smart Money API as 29 tools an assistant can use on its own: it picks the right tool, fills in the parameters and answers in plain language, with real on-chain data instead of guesses. It is a remote server — nothing to download or run. All tools are read-only: the server returns data and never signs transactions or touches funds. #### Connect in one minute Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card) and replace `YOUR_KEY` below. | Server URL | `https://mcp.cabalspy.xyz/mcp` | | --- | --- | | Transport | Streamable HTTP | | Auth | Header `X-CabalSpy-Key: YOUR_KEY`, or `?api_key=YOUR_KEY` on the URL | ##### Claude Code Terminal ``` claude mcp add --transport http cabalspy https://mcp.cabalspy.xyz/mcp \ --header "X-CabalSpy-Key: YOUR_KEY" ``` ##### Cursor Use the [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cabalspy&config=eyJ1cmwiOiJodHRwczovL21jcC5jYWJhbHNweS54eXovbWNwIiwiaGVhZGVycyI6eyJYLUNhYmFsU3B5LUtleSI6IllPVVJfS0VZIn19) button, or add this to `~/.cursor/mcp.json`: ~/.cursor/mcp.json ``` { "mcpServers": { "cabalspy": { "url": "https://mcp.cabalspy.xyz/mcp", "headers": { "X-CabalSpy-Key": "YOUR_KEY" } } } } ``` ##### VS Code Use the [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22cabalspy%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cabalspy.xyz%2Fmcp%22%2C%22headers%22%3A%7B%22X-CabalSpy-Key%22%3A%22YOUR_KEY%22%7D%7D) button, or add this to `.vscode/mcp.json`: .vscode/mcp.json ``` { "servers": { "cabalspy": { "type": "http", "url": "https://mcp.cabalspy.xyz/mcp", "headers": { "X-CabalSpy-Key": "YOUR_KEY" } } } } ``` ##### Claude Desktop, claude.ai and other clients Clients that only take a URL (for example custom connectors in claude.ai) can pass the key as a query parameter: Connector URL ``` https://mcp.cabalspy.xyz/mcp?api_key=YOUR_KEY ``` Where a client lets you set headers, prefer the header — it keeps the key out of logs. #### Things to ask - Who are the best performing Solana KOLs this week? - What are KOLs buying right now? - Was this token launch bundled? - Who is still holding this token and who already sold? - Which Smart Money wallets entered the same token in the last 6 hours? - Is this wallet a tracked KOL?
- What do verified holders think about $BONK? - Who owns this wallet?
#### All 29 tools ##### Wallets | `list_wallets` | Browse the KOL, Smart Money or Whale wallets tracked on a chain. | | --- | --- | | `lookup_wallet` | Identify an address: is it tracked, and under which name, X and Telegram. | | `get_leaderboard` | Top wallets by performance for a chain, wallet type and period. | | `get_wallet_tracker` | Period stats for one wallet: realized PnL, win rate, volume, trades. | | `get_wallet_holdings` | Current on-chain token holdings of a wallet, read live. | | `get_wallet_history` | Lifetime trading history with per-token overview and trades. | | `get_pnl_calendar` | Daily and monthly realized PnL, for spotting streaks. | | `get_wallet_connections` | Wallets that traded the same tokens — groups that move together. | | `compare_wallets` | Statistics for up to 100 wallets in one request. | ##### Tokens | `get_token_stats` | Who is trading a token: KOL, Smart Money and Whale counts, buying pressure, positions. | | --- | --- | | `get_token_holders` | Tracked wallets still holding a token, sorted by balance. | | `get_token_transactions` | Individual buys and sells by tracked wallets in one token. | | `detect_bundles` | Was a Solana launch bundled? KOL bundles with confidence score and evidence. | | `compare_tokens` | Statistics for up to 100 tokens in one request. | ##### Market feed and signals | `get_recent_trades` | The live feed: what tracked wallets are buying and selling right now. | | --- | --- | | `get_signals` | Tokens where several tracked wallets acted in the same window (cluster, entry, exit). | | `get_signal_history` | Past signals, to check how a kind of signal worked historically. | | `get_activity_metrics` | Trade count, volume and distinct wallets over a window of up to 24 hours. | | `get_analytics` | Aggregate views: volume trend, most traded tokens, win rates, top performers. | ##### CabalSpy ID (SocialFi) | `csid_profile` | Verified trader identity by X handle, CSID id or wallet: X account, KOL badge, wallets proven on-chain, 7-day activity. | | --- | --- | | `csid_wallet_owner` | Who owns a wallet? The CabalSpy ID user who verified it, for 1 to 100 addresses. | | `csid_kols` | KOLs with a reviewed CabalSpy ID badge, per chain. | | `csid_token_theses` | What verified holders think about a token: bull/bear summary and theses with each author live position and PnL. | | `csid_latest_theses` | The newest theses across all tokens, from every platform that uses CabalSpy ID. | | `csid_user_theses` | Every thesis one trader posted, with the token and their position. | | `csid_thesis` | One thesis with its replies. | | `csid_leaderboard` | Verified traders of your CabalSpy ID instance ranked by volume, PnL, win rate or trades. | ##### Service | `get_api_status` | Health, supported chains and how many wallets are tracked per chain. | | --- | --- | | `get_started` | How to get a free API key, pricing, docs and data caveats. | #### Coverage Solana has KOL, Smart Money and Whale wallets; BNB Chain, Base, Ethereum and Robinhood Chain have KOL and Smart Money — 5,500+ labeled wallets in total. Statistics are available for 6 hours, 1 day, 7 days and 30 days. Market cap and price in USD are returned for Solana tokens. #### Who uses it - **Traders** — research a token or a wallet in a chat instead of five dashboards - **AI agent builders** — give a trading or research agent a labeled-wallet data source without writing API glue - **Developers** — explore the API from the editor before integrating the [REST and WebSocket API](https://www.cabalspy.xyz/kol-api/) - **Analysts** — check whether a launch was bundled or which wallets move together Found a token worth trading? Open it in the [CabalSpy Terminal](https://app.cabalspy.xyz/). #### Frequently asked questions 01 ##### What is the CabalSpy MCP server? The CabalSpy MCP server connects AI assistants such as Claude, Cursor, VS Code Copilot and ChatGPT to CabalSpy's labeled wallet data. Through 29 read-only tools the assistant can look up KOL, Smart Money and Whale wallets, see what they are buying right now, check token holders, detect bundled launches and read cluster signals on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. 02 ##### How do I connect the CabalSpy MCP server? Add the remote server URL https://mcp.cabalspy.xyz/mcp to your MCP client and pass your CabalSpy API key in the X-CabalSpy-Key header. Clients that cannot send custom headers, such as claude.ai connectors, can append the key to the URL as ?api_key=YOUR_KEY instead. No local installation is needed. 03 ##### Is the CabalSpy MCP server free? The server itself is free to connect. It uses your CabalSpy API key, and the free tier includes 10,000 credits per month (1,000 requests) with no credit card. Paid plans start at $49/month. 04 ##### Can the MCP server trade or move funds? No. Every tool is read-only: the server only returns data about tracked wallets, tokens, trades and signals. It never holds keys, signs transactions or places trades. 05 ##### Which chains and wallet types does it cover? Solana (KOL, Smart Money and Whale wallets), BNB Chain, Base, Ethereum and Robinhood Chain (KOL and Smart Money). Market cap and price in USD are returned for Solana tokens only. 06 ##### Which AI clients work with it? Any client that supports remote MCP servers over Streamable HTTP, including Claude Code, Claude Desktop and claude.ai connectors, Cursor, VS Code, Windsurf and ChatGPT developer mode. #### Related [SDKs](https://www.cabalspy.xyz/sdks/)[x402 for AI agents](https://www.cabalspy.xyz/x402/)[KOL API](https://www.cabalspy.xyz/kol-api/)[Smart Money API](https://www.cabalspy.xyz/smart-money-api/)[Use cases](https://www.cabalspy.xyz/use-cases/)[Signals](https://www.cabalspy.xyz/use-cases/kol-signals/)[Bundle detection](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/)[Source on GitHub](https://github.com/CabalSpy/CabalSpy-MCP-Server)[API docs](https://docs.cabalspy.xyz/) #### Give your AI real wallet data. Free API key, no credit card. 10,000 free credits every month. One URL, 29 read-only tools, five chains. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## CabalSpy SDKs — TypeScript, Python & Rust for the KOL & Smart Money API URL: https://www.cabalspy.xyz/sdks/ > Official CabalSpy SDKs for TypeScript, Python and Rust: typed access to KOL, Smart Money and Whale wallet data, leaderboards, signals and real-time streams. npm install cabalspy. ### SDKs — the KOL API in TypeScript, Python and Rust Official, open-source clients for the CabalSpy **KOL and Smart Money API**. Typed responses, pagination, reconnecting WebSocket streams — from install to first result in a minute. [Get free API key](https://apidashboard.cabalspy.xyz/register)[GitHub](https://github.com/CabalSpy) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Developer Tools · SDKs #### Install, authenticate, query KOL wallets | Language | Install | REST | WebSocket | Source | | --- | --- | --- | --- | --- | | TypeScript / JavaScript | `npm install cabalspy` | Full v1 | 6 streams | [cabalspy-js](https://github.com/CabalSpy/cabalspy-js) | | Python | `pip install cabalspy` | Full v1, sync + async | 6 streams | [cabalspy-python](https://github.com/CabalSpy/cabalspy-python) | | Rust | `cabalspy = "0.1"` | Full v1 | — | [cabalspy-rust](https://github.com/CabalSpy/cabalspy-rust) | All SDKs read the key from `CABALSPY_API_KEY` and cover Solana, BNB Chain, Base, Ethereum and Robinhood Chain with the wallet types `kol`, `smart` and `whale`. #### TypeScript Install ``` npm install cabalspy ``` Quick start ``` import { CabalSpy } from 'cabalspy'; const client = new CabalSpy({ apiKey: process.env.CABALSPY_API_KEY }); // Who is this wallet? Searches every chain and wallet type. const wallet = await client.wallets.lookup('DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK'); // Leaderboard of the best KOL wallets on Solana over 7 days const board = await client.wallets.leaderboard({ blockchain: 'solana', type: 'kol', period: '7d', limit: 25, }); // Live cluster signals: 5+ KOLs buying the same token within an hour const signals = await client.signals.list({ blockchain: 'solana', type: 'kol', mode: 'cluster', min_wallets: 5, hours: 1, }); ``` Real-time streams run over one socket; subscriptions survive reconnects automatically: Realtime ``` const rt = client.realtime(); rt.on('position_update', (msg) => console.log('trade', msg.data)); rt.on('signal', (msg) => console.log('signal', msg.data)); await rt.connect(); rt.subscribe({ stream: 'tx', blockchain: 'solana', type: 'kol', token: '*' }); ``` #### Python Install ``` pip install cabalspy pip install "cabalspy[realtime]" # for WebSocket streams ``` Quick start ``` from cabalspy import CabalSpy client = CabalSpy() # reads CABALSPY_API_KEY # Who is this wallet? Searches every chain and wallet type. wallet = client.wallets.lookup("As7HjL7dzzvbRbaD3WCun47robib2kmAKRXMvjHkSMB5") print(wallet["name"], wallet["type"]) # Best KOL wallets on Solana over 7 days board = client.wallets.leaderboard(blockchain="solana", type="kol", period="7d", limit=25) # Live cluster signals: 5+ KOLs buying the same token within an hour signals = client.signals.list( blockchain="solana", type="kol", mode="cluster", min_wallets=5, hours=1 ) for signal in signals["signals"]: print(signal["token"]["token_name"], signal["window"]["wallet_count"]) ``` Every method also exists on `AsyncCabalSpy` with the same signature, for bots and agents that already run an event loop. #### Rust Cargo.toml ``` [dependencies] cabalspy = "0.1" tokio = { version = "1", features = ["macros", "rt-multi-thread"] } ``` Quick start ``` use cabalspy::{CabalSpy, Chain, LeaderboardOpts, Period, WalletType}; #[tokio::main] async fn main() -> Result<(), cabalspy::Error> { let client = CabalSpy::from_env()?; // reads CABALSPY_API_KEY let wallet = client.wallets().lookup("As7HjL7dzzvbRbaD3WCun47robib2kmAKRXMvjHkSMB5").await?; println!("{:?}", wallet.data); let board = client.wallets().leaderboard(Chain::Solana, LeaderboardOpts { wallet_type: Some(WalletType::Kol), period: Some(Period::D7), limit: Some(25), ..Default::default() }).await?; Ok(()) } ``` Impossible combinations — for example Whale wallets on Ethereum — are rejected before a request goes out, so a mistake costs no credits. #### More ways to integrate [MCP ServerKOL data inside Claude, Cursor and VS Code](https://www.cabalspy.xyz/mcp/)[x402 for AI agentsPay per request in USDC, no API key](https://www.cabalspy.xyz/x402/)[Use casesCharts, leaderboards, signals and more](https://www.cabalspy.xyz/use-cases/)[API referenceEvery endpoint and stream](https://docs.cabalspy.xyz/) #### Example projects [Wallet tracker (Next.js)](https://github.com/CabalSpy/Wallet-Tracker-Demo)[Leaderboard](https://github.com/CabalSpy/Leaderboard-Demo)[Real-time holder table](https://github.com/CabalSpy/kol-realtime-holder-table)[TradingView integration](https://github.com/CabalSpy/kol-tradingview-integration) #### Frequently asked questions 01 ##### Which SDKs does CabalSpy offer? CabalSpy publishes official SDKs for TypeScript/JavaScript (npm install cabalspy), Python (pip install cabalspy) and Rust (the cabalspy crate). All three cover the v1 REST API; the TypeScript and Python SDKs also include the WebSocket streams with automatic re-subscription after a reconnect. 02 ##### Is there a Python SDK for KOL wallet data? Yes. Install it with pip install cabalspy. It offers a synchronous CabalSpy client and an AsyncCabalSpy client with the same methods; realtime streams need the extra pip install "cabalspy[realtime]". 03 ##### Do I need an SDK to use the API? No. The API is plain REST and WebSocket, so curl or any HTTP client works. The SDKs add typed responses, pagination helpers, reconnecting streams and validation that rejects impossible chain and wallet-type combinations before a request is sent. 04 ##### How do I authenticate with the SDK? Create a free API key at apidashboard.cabalspy.xyz and set it as the CABALSPY_API_KEY environment variable, or pass it to the client constructor. The free tier includes 10,000 credits per month. 05 ##### Are the SDKs open source? Yes. The source for all SDKs is on GitHub under github.com/CabalSpy, together with demo projects for a wallet tracker, a leaderboard, a real-time holder table and a TradingView integration. #### Three languages, one API key. Start free today. 10,000 free credits every month, REST and WebSocket access, no credit card. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## x402 for AI Agents — Pay per Request for KOL Data, No API Key | CabalSpy URL: https://www.cabalspy.xyz/x402/ > AI agents pay per request in USDC for KOL, Smart Money and Whale wallet data — no account, no signup, no API key. x402 clients for TypeScript and Python with built-in spend limits. ### x402 — AI agents pay per request, no API key With **x402**, an AI agent pays in USDC for each CabalSpy API call and gets labeled KOL, Smart Money and Whale wallet data — no account, no signup, no key. The wallet is the identity, and spend limits are on by default. [TypeScript client](https://github.com/CabalSpy/cabalspy-x402)[Python client](https://github.com/CabalSpy/cabalspy-x402-python) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Agentic Payments · x402 #### KOL data your agent can buy on its own #### How it works - The agent calls a CabalSpy endpoint. The server answers `402 Payment Required` with the price. - The client checks the price against your spend limits, **before the wallet signs anything**. - It pays in USDC and repeats the request; the data comes back. You get a full CabalSpy client — every endpoint, every type, every error class. Only the payment differs. Gas is sponsored by the facilitator, so you pay only the price of the call. #### TypeScript Install ``` npm install cabalspy-x402 ``` Quick start ``` import { createClient } from 'cabalspy-x402'; const cabalspy = createClient({ signer, // Solana signer evmSigner, // Base, Polygon, Arbitrum — either or both maxSpendTotal: '$5.00', // hard cap for this process }); const wallet = await cabalspy.wallets.lookup('As7HjL7dzzvbRbaD3WCun47robib2kmAKRXMvjHkSMB5'); console.log(wallet.name, wallet.type); // Otta kol console.log(cabalspy.x402.summary()); // { calls: 1, spentUsd: 0.01, remainingUsd: 4.99 } ``` #### Python Install ``` pip install "cabalspy-x402[all]" ``` Quick start ``` from cabalspy_x402 import create_client cabalspy = create_client( svm_signer=signer, # Solana max_spend_total="$5.00", # hard cap for this process ) wallet = cabalspy.wallets.lookup("As7HjL7dzzvbRbaD3WCun47robib2kmAKRXMvjHkSMB5") print(wallet["name"], wallet["type"]) # Otta kol print(cabalspy.x402.summary()) # {'calls': 1, 'spent_usd': 0.01, 'remaining_usd': 4.99} ``` An async client (`create_async_client`) is available for agents that already run an event loop. #### Spend limits are on by default A funded wallet handed to an autonomous agent is a standing authorisation to spend. An agent stuck in a retry loop against a paid endpoint would drain it. So both limits are active unless you turn them off: | Limit | Default | Effect | | --- | --- | --- | | Per call | $0.10 | Refuses any single call priced above it | | Total | $10.00 | Refuses further calls once reached | Every settled payment is reported with timestamp, amount, on-chain transaction, network and URL, so you can keep your own ledger. #### Pay on Solana, Base, Polygon or Arbitrum CabalSpy offers all four networks in the same response. Register every network you hold USDC on — a client that can only pay on one chain is turned away whenever that chain has a problem. The payment chain is independent of the data you ask for. Test first on `solana-devnet`: no real money moves and the flow is identical. #### Use it from any HTTP layer Just the fetch ``` import { createPaymentFetch } from 'cabalspy-x402'; const { fetch: pay, tracker } = createPaymentFetch({ signer, maxSpendTotal: '$1.00' }); const res = await pay('https://api.cabalspy.xyz/v1/signals?blockchain=solana&type=kol'); ``` #### What agents ask | Who is this wallet? | `wallets.lookup` | | --- | --- | | How has this KOL performed? | `wallets.tracker` | | What are KOLs buying right now? | `transactions.latest` | | Was this launch bundled? | `bundle.get` (Solana) | | Who still holds this token? | `tokens.holders` | | Which wallets moved together? | `signals.list` | #### Other ways to connect an agent [MCP ServerFor Claude, Cursor and VS Code — with an API key](https://www.cabalspy.xyz/mcp/)[SDKsTypeScript, Python and Rust with an API key](https://www.cabalspy.xyz/sdks/)[KOL APIWhat data the API provides](https://www.cabalspy.xyz/kol-api/) #### Frequently asked questions 01 ##### What is x402? x402 is an open payment protocol built on the HTTP status code 402 "Payment Required". A server answers a request with a price, the client pays in stablecoin and repeats the request with proof of payment. It lets software — including AI agents — pay for an API call without an account, a subscription or an API key. 02 ##### How can an AI agent use the CabalSpy API without an API key? Install the cabalspy-x402 client (npm install cabalspy-x402 or pip install "cabalspy-x402[all]"), give it a wallet signer funded with USDC, and call the API as usual. The client pays per request automatically. No signup, no account and no API key are needed; the wallet is the identity. 03 ##### Which chains can I pay on? CabalSpy accepts USDC payments on Solana, Base, Polygon and Arbitrum and offers all of them in the same response. The payment chain is independent of the data: a question about a Base wallet can be paid for in Solana USDC. 04 ##### How do I stop an agent from overspending? Spend limits are on by default: $0.10 per call and $10.00 in total per process. The price is read from the 402 response and checked before the wallet signs anything, so a request priced above the limit is refused without spending. Both limits can be changed or disabled explicitly. 05 ##### Can I test x402 without real money? Yes. Restrict the client to a test network such as solana-devnet. No real money moves and the whole flow is identical. 06 ##### Should I use x402 or an API key? Use x402 when an autonomous agent should pay as it goes with no account to manage. Use an API key when you want a monthly plan with predictable cost: the free tier includes 10,000 credits per month and paid plans start at $49/month. Both return the same data. #### Prefer a monthly plan? Use an API key instead. 10,000 free credits every month with an API key, no credit card. x402 and API keys return the same data. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## CabalSpy — API & Widget Pricing · KOL, Smart Money & Whale Wallet Data URL: https://www.cabalspy.xyz/pricing/ > Transparent pricing for the CabalSpy API, Widget and CabalSpy ID (SocialFi API). Plans starting free up to enterprise — REST API, WebSocket streams, embeddable widget, multi-chain labeled-wallet data on Solana, BNB, Base, Ethereum and Robinhood. ### Pricing built for builders, from solo to enterprise. MonthlyYearlySave 20% ##### Free Build a prototype, test labels, run side-projects — up to ~1,000 requests/month. $0/mo 10,000 Credits / monthA **credit** is what you spend per API call. **10 credits** per REST request, **1 credit** per WebSocket event received. - REST API access - WebSocket data streams - 5 Req/s - No credit card · Cancel anytime [Start for free](https://apidashboard.cabalspy.xyz/register) ##### Starter For indie devs & alpha groups — track up to 50 wallets across 10k requests/month. $49/moSave $10/mo 100,000 Credits / monthA **credit** is what you spend per API call. **10 credits** per REST request, **1 credit** per WebSocket event received. - REST API access - WebSocket data streams - 20 Req/s [Get Starter](https://apidashboard.cabalspy.xyz/register) Most Popular ##### Pro Most chosen by paying teams Enough for 500 KOL wallets — e.g. KOLs, Smart Money & Whales on Solana. $249/moSave $50/mo 1,000,000 Credits / monthA **credit** is what you spend per API call. **10 credits** per REST request, **1 credit** per WebSocket event received. - REST API access - WebSocket data streams - 50 Req/s - Up to 3 API keys - Priority support [Get Pro](https://apidashboard.cabalspy.xyz/register) ##### Business All chains, all wallet categories — full multichain coverage. $499/moSave $100/mo 2,000,000 Credits / monthA **credit** is what you spend per API call. **10 credits** per REST request, **1 credit** per WebSocket event received. - REST API access - WebSocket data streams - 100 Req/s - Up to 5 API keys - Widget Starter plan included - Early feature access - Dedicated support [Get Business](https://apidashboard.cabalspy.xyz/register) Enterprise ##### Need more than 2M credits? Custom throughput, dedicated infrastructure, SLA-backed uptime, early access to new features and the embeddable widget — all included. Built for trading terminals, AlphaBots and AI agents at scale. - Custom throughput - Dedicated support - SLA guarantees - Early feature access - Widget included - GDPR compliant Trusted by: [Telegram@Tokiogaijin](https://t.me/Tokiogaijin)[Emailcontact@cabalspy.xyz](mailto:contact@cabalspy.xyz?subject=Enterprise%20plan%20inquiry) ##### Widget Starter Drop the widget on one site — ideal for community sites & single-app launches. $199/moSave $40/mo ~250 Daily usersAverage **unique daily users** who load the widget on your site. Indicative limit — bursts allowed. - 1 domain - Embeddable widget - KOL, Smart Money & Whale labels - Solana, BNB, Base, ETH, Robinhood support [Get Starter](https://apidashboard.cabalspy.xyz/register) Most Popular ##### Widget Pro Picked by trading terminals scaling to 1k+ DAU Embed across up to 3 domains — for multi-product trading platforms. $499/moSave $100/mo ~1,000 Daily usersAverage **unique daily users** who load the widget on your site. Indicative limit — bursts allowed. - 3 domains (same project) - Embeddable widget - KOL, Smart Money & Whale labels - Priority support [Get Pro](https://apidashboard.cabalspy.xyz/register) ##### Enterprise For trading exchanges & terminals serving 10k+ daily users across multiple products. Custom 1,000+ Daily usersAverage **unique daily users** who load the widget on your site. Indicative limit — bursts allowed. - Unlimited domains - Custom user limits - SLA-backed uptime - Dedicated support - Early feature access [Contact sales](mailto:hello@cabalspy.xyz?subject=Widget%20Enterprise%20inquiry) ##### Free Try the login button and the Data API on your app. $0/mo - **50** users with data - Data API · 1 req/s - Unlimited sign-ins - Token theses (widget + API) [Start free](https://apidashboard.cabalspy.xyz/csid) ##### Starter For a first live launch with verified users. $49/mo or $468 / year - **200** users with data - Data API · 5 req/s - Unlimited sign-ins - Token theses (widget + API) - Pay by card or crypto [Get Starter](https://apidashboard.cabalspy.xyz/billing/csid) Live stream ##### Pro Adds the live WebSocket stream of your users’ trades. $149/mo or $1,428 / year - **500** users with data - Data API · 10 req/s - Unlimited sign-ins - Token theses (widget + API) - WebSocket trade stream - Pay by card or crypto [Get Pro](https://apidashboard.cabalspy.xyz/billing/csid) ##### Business For larger platforms and communities. $499/mo or $4,788 / year - **1,000** users with data - Data API · 25 req/s - Unlimited sign-ins - Token theses (widget + API) - WebSocket trade stream - Pay by card or crypto [Get Business](https://apidashboard.cabalspy.xyz/billing/csid) CabalSpy ID Enterprise ##### Need more than 1,000 users? Unlimited users with data, a custom API rate with SLA, and global scope — query every CabalSpy ID user, not only the ones who signed in to your app. - Unlimited users - Custom rate + SLA - Global scope - WebSocket trade stream - Token theses (widget + API) [Contact sales](mailto:contact@cabalspy.xyz?subject=CabalSpy%20ID%20Enterprise) **Token theses are included on every plan** — widget, API, live theses stream and moderation. Reach: all platforms or only your instance. **Above your limit?** Sign-in keeps working — extra users arrive anonymous, without profile or wallet data, until you upgrade. SocialFi API pricing · Prices per month and per domain · Yearly billing saves 20% · [What is CabalSpy ID?](https://www.cabalspy.xyz/cabalspy-id/) #### Compare every plan side-by-side | Feature | Free | Starter | Pro | Business | | --- | --- | --- | --- | --- | | Credits & Limits | | | | | | Monthly credits | 10,000 | 100,000 | 1,000,000 | 2,000,000 | | Credits per REST request | 10 | 10 | 10 | 10 | | Credits per WebSocket event | 1 | 1 | 1 | 1 | | Requests per second | 5 Req/s | 20 Req/s | 50 Req/s | 100 Req/s | | Data Access | | | | | | REST API access | | | | | | WebSocket streams | | | | | | Historical data (since Feb 2025) | | | | | | Wallet Categories | | | | | | KOL tracking | | | | | | Smart Money tracking | | | | | | Whale tracking | | | | | | Chains Supported | | | | | | Solana, BNB, Base, Ethereum, Robinhood Chain | | | | | | Support | | | | | | Priority support | — | — | | — | | Dedicated support | — | — | — | | | Early feature access | — | — | — | | | Account & Billing | | | | | | API keys | 1 | 1 | 3 | 5 | | Widget Starter plan included | — | — | — | | | Pay in Crypto | — | | | | | Pay with credit card | — | | | | 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA #### Frequently asked questions 01What's included in the free plan? 10,000 credits per month, full REST API access, all chains, all wallet categories. Perfect for testing the API and small personal projects. 02How do credits work? Each REST API request consumes 10 credits. Each WebSocket event received consumes 1 credit. Credits reset on the first of every month. 03Can I upgrade or downgrade my plan? Yes — change your plan anytime from the API Dashboard. Upgrades take effect immediately and are pro-rated for the current billing cycle. Downgrades apply on your next billing date. 04What's the difference between API and Widget plans? API plans give you raw data via REST and WebSocket — you build your own UI. Widget plans give you our pre-built embeddable widget that you drop into your site with a single line of code, billed by domain count and daily active users instead of credits. 05Which chains do you support? Solana, BNB, Base, ETH and Robinhood are live. 06Do you offer custom enterprise plans? Yes. Enterprise plans include custom throughput, dedicated support, SLA-backed uptime, early access to new features, and the widget. [Contact us](mailto:hello@cabalspy.xyz) for a quote. 07What payment methods do you accept? Crypto payments (Solana, USDC, USDT) and credit cards via our payment provider MoonPay. 08Can I cancel anytime? Yes, cancel anytime from your API Dashboard. Your plan stays active until the end of the current billing period. We don't refund partial months. 09Are there setup fees or hidden costs? No setup fees, no hidden costs. You pay the monthly subscription, that's it. Yearly billing gives you 20% off compared to monthly. 10Do you offer a trial for paid plans? Our free tier (10,000 credits/month) is your trial. Test the entire API for as long as you need before upgrading. #### Start with the free tier. Scale when you're ready. 10,000 credits free, every month. No credit card required. Upgrade only when you outgrow it. [Start for free](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/) --- ## CabalSpy ID — SocialFi API, SDK & Widget for any platform | CabalSpy URL: https://www.cabalspy.xyz/cabalspy-id/ > CabalSpy ID is the SocialFi API, SDK and widget for any platform or app — trading, games, communities. One login gives you every user's X identity, verified wallets and every trade, live on 5 chains. CabalSpy ID · for platforms & apps ### The SocialFi layer. One login gives your platform or app a social layer: every user’s X identity, their verified wallets and every trade they make — tracked live on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. With built-in token theses from day one. [Add CabalSpy ID to your platform](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id) For trading terminals, DEXs, launchpads, bots, wallets, games, communities — any app · I’m a trader → What it is #### Your users and their trades, as a social layer 01 ##### Users sign in “Login with CabalSpy ID” — with X, Telegram or Google 02 ##### Identity + wallets X profile and verified wallets, with consent 03 ##### Every trade tracked Live, on 5 chains — no indexing on your side 04 ##### Delivered to you Data API, WebSocket stream and webhooks 05 ##### Social features Built-in token theses — plus your leaderboards, feeds, copy trading … Use cases #### What you can build with CabalSpy ID Everything below runs on the same data: who your users are, which wallets are theirs and every trade they make. ##### Leaderboards of your users Rank your own community by PnL, win rate, volume or trades — per chain and per period. `/v1/wallets/leaderboard` ##### Token theses & chats Built in: holders post their thesis on a token, with their real position and live PnL next to it. Embed the widget or use the API. `thesis widget · API · stream` ##### Your users’ trades on the chart Plot the buys and sells of your community and KOLs as markers on the token chart. `/v1/wallets/history · stream` ##### Live activity feed A real-time stream of what your users are trading right now. `WebSocket /v1/stream` ##### Copy trading & follow Let people follow and copy traders with verified, tracked performance — not claims. `tracker · stream` ##### Trader profiles Stats, PnL chart, holdings and PnL calendar for every user, inside your platform. `tracker · holdings · pnl_calendar` ##### Verified & KOL badges Show who is verified and who is a reviewed KOL. Fake callers stand out. `/v1/profile` ##### Competitions & rewards Run trading competitions, rewards and referrals based on real on-chain trading. `leaderboard · webhooks` Illustrations. Your platform builds the interface — CabalSpy ID supplies identities, wallets, stats and trades. Built in · Token theses #### Why do they hold? Proven theses. A ready-made SocialFi widget for your token pages: holders explain why they hold a token. Every thesis shows the author’s real, on-chain verified position and live PnL — when they exit, it’s marked **Sold**. No more anonymous shilling. - **Bullish or bearish** tag on every thesis - **Replies, likes and emoji reactions** - **Reports and moderation** included - **Shared network:** a token shows theses from all platforms by default — content from day one. Or switch to “only my instance”. - **Stats per instance** in the dashboard [Try it live](https://id.cabalspy.xyz/try/thesis)[Theses docs](https://docs.cabalspy.xyz/cabalspy-id/theses) **@trader_a**verified holderBullish Team ships every week, volume keeps climbing and the community is real. Holding until the next listing. Position**1.2M $TOKEN**Live PnL**+38.4%**SOL 246🚀 9 · 🔥 4 **@trader_b**bearish · position closedSold Illustration — handles and numbers are examples. Option 1 · Widget ##### Two lines, fully designable Paste the widget and style it in the dashboard — colors, font, radius, theme, sort and reach — with a live preview. Users signed in with CabalSpy ID write directly. HTML ```
``` Option 2 · Your own UI ##### Data API, WebSocket & webhooks - Read theses for any token - Post from your own button, in the user’s name - Live WebSocket — subscribe to any number of tokens, e.g. thesis markers on your chart - Webhook `thesis.created` For traders #### One identity. Every platform. - A verified public profile with your real PnL, win rate and trades - One login on every platform that supports CabalSpy ID - Get discovered, followed and copied — on the public leaderboard and on partner platforms - A KOL badge after review - You stay in control: hide your trading data, revoke apps or delete your ID at any time [IDSign in with CabalSpy ID](https://id.cabalspy.xyz/auth/x/login) See it live[**Public leaderboard**Traders with verified wallets, by chain and period](https://id.cabalspy.xyz/leaderboard)[**Example profile**@CabalSpySol](https://id.cabalspy.xyz/u/CabalSpySol) Why platforms add it #### Social keeps traders on your platform ##### Retention & engagement Social features give users a reason to come back: rankings, followers, discussions around real trades. ##### Trust Verified people and real, tracked PnL instead of screenshots and anonymous claims. ##### Nothing to build underneath No wallet indexing, no PnL engine, no identity system. You build the features, we deliver the data. ##### One integration, 5 chains One login and one API for Solana, BNB Chain, Base, Ethereum and Robinhood Chain. ##### Privacy by consent Users approve what your app may see and can revoke access at any time. How to integrate #### Live in three steps A complete SocialFi integration: login, verified wallets and live trades through one SocialFi API — with SDKs for JavaScript/TypeScript and Python. 01**Create an instance**In the API dashboard — same API key as the CabalSpy API. Start in sandbox with test users. 02**Add the login button**Design it in the button builder and paste two lines. Standard OpenID Connect with PKCE. 03**Use the data**Query the Data API, subscribe to the WebSocket stream and receive webhooks. Login button HTML ```
``` Signed-in users get their avatar and a menu in the button. Browser apps receive a `csid:login` event with the user and ID token. Data API cURL · leaderboard of your users ``` curl -G https://api-id.cabalspy.xyz/v1/wallets/leaderboard \ -d blockchain=solana -d period=7d -d sort=pnl \ -H "Authorization: Bearer YOUR_KEY" ``` Also: users, profiles, wallet lookup, stats & PnL chart, trade history, holdings, PnL calendar, latest trades — and `wss://…/v1/stream` for live trades (Pro and up). [Add CabalSpy ID to your platform](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id)[SocialFi API docs & SDKs](https://www.cabalspy.xyz/socialfi-api/)[See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) Built on verification #### Real people. Real wallets. ##### Wallets proven on-chain Users prove a wallet with a tiny on-chain payment from it. No wallet connect, no signature prompt. ##### Reviewed KOL badge Minimum to apply: 5k+ X followers, an X account older than 90 days and $25k+ volume in the last 7 days. We look for around $100k+ weekly volume; every application is reviewed manually. ##### X, Telegram or Google Users sign in with X, Telegram or Google. X and Telegram are the social identities; Google is an alternative sign-in. #### Questions from platforms 01What is CabalSpy ID? The SocialFi layer for any platform or app — trading terminals, DEXs, launchpads, bots, wallets, games or communities. Your users sign in with CabalSpy ID; you get their X profile, their verified wallets and every trade they make on Solana, BNB Chain, Base, Ethereum and Robinhood Chain — via OpenID Connect, a Data API, a WebSocket stream and webhooks. You build the social features on top. 02Do we need our own wallet indexing or PnL calculation? No. Every verified wallet is tracked by CabalSpy. Stats, realized PnL, PnL chart, trades, holdings and PnL calendar come ready from the Data API — the same numbers as the CabalSpy API. 03What does a user have to do? Sign in with X, verify their wallets with a tiny on-chain payment (no wallet connect, nothing to sign) and approve your app. They can revoke access at any time. 04How do we receive the data? Sign-in uses standard OpenID Connect (authorization code + PKCE). The Data API at api-id.cabalspy.xyz/v1 returns users, profiles, wallets, stats, trades, holdings, PnL calendars and leaderboards. The WebSocket stream pushes every trade of your users live (Pro plan and up). Webhooks fire on wallet.verified, wallet.removed, profile.updated, kol.granted and consent.revoked. 05Do we need a separate API key? No. CabalSpy ID uses the same API key as the CabalSpy API — switch on “CabalSpy ID” for the key in the API dashboard. Instances, the login button builder, webhooks and a sandbox with test users live there too. 06What does it cost? You can start on the free plan. Paid plans scale with the number of users whose data you receive; above your limit sign-in keeps working, but extra users arrive without data until you upgrade. Token theses — widget, API, live theses stream and moderation — are included on every plan. [See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) #### Give your users a social layer. Start free in the API dashboard — sandbox with test users included. [Add CabalSpy ID to your platform](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id)[See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) --- ## SocialFi API, SDK & Widget — CabalSpy ID | CabalSpy URL: https://www.cabalspy.xyz/socialfi-api/ > The SocialFi API and SDK for any platform: X login, verified wallets, live trades and token theses of your users on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. REST, WebSocket, webhooks and widgets. Free plan. ### SocialFi API — social layer, verified on-chain CabalSpy ID is **the SocialFi API and SDK for any platform**: your users sign in with X, prove their wallets on-chain, and every trade they make is tracked live on Solana, BNB Chain, Base, Ethereum and Robinhood Chain — delivered to you via REST, WebSocket, webhooks and drop-in widgets. [Start free](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id) Developer Guide · SocialFi API #### Everything you need to know about the SocialFi API #### What is a SocialFi API? SocialFi combines social features with real on-chain activity. A **SocialFi API** gives your product both sides: who a user is, which wallets are provably theirs and what they actually trade. CabalSpy ID delivers this as one integration — you build the social experience, CabalSpy handles identity, wallet verification and trade tracking. #### SocialFi integration: login, verified wallets, live trades - **Login with CabalSpy ID** — standard OpenID Connect (authorization code + PKCE). Users sign in with their X account; you receive their profile, verified wallets and KOL badge. - **Verified wallets** — users prove a wallet with a tiny on-chain payment. No wallet connect, no signature prompt. - **Every trade, live** — all trades of verified wallets are tracked automatically. No indexing on your side. - **Data API** at `api-id.cabalspy.xyz/v1` — users, profiles, wallet lookup, stats and PnL chart, trade history, holdings, PnL calendar, leaderboards and latest trades. - **WebSocket stream** of every trade of your users (Pro plan and up) and **webhooks** for `wallet.verified`, `wallet.removed`, `profile.updated`, `kol.granted`, `consent.revoked` and `thesis.created`. #### SocialFi widget: login button and token theses Not every feature needs your own UI. Two widgets come ready to embed and are designed in the dashboard: - **Login button** — “Login with CabalSpy ID” in two lines of HTML. Signed-in users see their avatar and a menu. - **Token theses** — holders explain why they hold a token, and every thesis shows their real, on-chain verified position and live PnL (marked “Sold” when they exit). Bullish/bearish tags, replies, likes, emoji reactions and moderation are included. By default a token shows theses from all platforms; you can switch to your own instance only. Widgets · HTML ```
``` #### SocialFi use cases - **Leaderboards** of your own users by PnL, win rate, volume or trades — per chain and period - **Token theses & chats** with proof of skin in the game - **Trades on the chart** — your community’s buys and sells as markers on the token chart - **Live activity feeds** of what your users trade right now - **Copy trading** and following based on verified, tracked performance - **Trader profiles** with stats, PnL chart, holdings and PnL calendar - **Verified & KOL badges** that make fake callers stand out - **Competitions and rewards** based on real on-chain trading For trading terminals, DEXs, launchpads, bots, wallets, games and communities — any app. See the [CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/) for how it works. #### Quick start: REST, JavaScript SDK and Python SDK Use the same API key as the CabalSpy API with the “CabalSpy ID” toggle enabled. A key sees its own instance: the users who signed in to your apps. REST · cURL ``` curl -G https://api-id.cabalspy.xyz/v1/wallets/leaderboard \ -d blockchain=solana -d period=7d -d sort=pnl_usd \ -H "Authorization: Bearer YOUR_KEY" ``` SocialFi SDK · JavaScript / TypeScript ``` // npm install cabalspy-id import { CabalSpyID } from 'cabalspy-id'; const csid = new CabalSpyID({ apiKey: process.env.CABALSPY_API_KEY }); // The person who just signed in: look them up by the sub of their ID token const profile = await csid.profile({ csid_id: claims.sub }); // Your users ranked by PnL const board = await csid.leaderboard({ blockchain: 'solana', period: '7d', sort: 'pnl_usd', limit: 25 }); ``` SocialFi SDK · Python ``` # pip install cabalspy-id from cabalspy_id import CabalSpyID csid = CabalSpyID() # reads CABALSPY_ID_API_KEY, then CABALSPY_API_KEY profile = csid.profile(csid_id=claims["sub"]) board = csid.leaderboard(blockchain="solana", period="7d", sort="pnl_usd", limit=25) ``` The JavaScript SDK also ships `CabalSpyIDAuth` for OpenID Connect, React components (``, ``), a `ThesisClient` and webhook verification. #### Chains Solana, BNB Chain, Base, Ethereum and Robinhood Chain — one login and one API for all of them. #### Pricing Plans are per month and per domain; yearly billing saves 20%. Token theses are included on every plan. | Plan | Price | Users with data | API rate | | --- | --- | --- | --- | | Free | $0 | 50 | 1 req/s | | Starter | $49/mo | 200 | 5 req/s | | Pro | $149/mo | 500 | 10 req/s + trade WebSocket | | Business | $499/mo | 1,000 | 25 req/s + trade WebSocket | | Enterprise | Custom | Unlimited | Custom + SLA | Full comparison on the [SocialFi API pricing page](https://www.cabalspy.xyz/pricing/#cabalspy-id). #### Frequently asked questions 01 ##### What is a SocialFi API? A SocialFi API connects social identity with on-chain activity. CabalSpy ID is a SocialFi API: your users sign in with their X account, prove their wallets on-chain, and every trade of those wallets is tracked live on Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Your platform receives profiles, verified wallets, KOL badges and trading stats through OpenID Connect, a REST Data API, a WebSocket stream and webhooks. 02 ##### How do I add SocialFi features to my app? Create a CabalSpy ID instance in the API dashboard, add the “Login with CabalSpy ID” button and read your users’ data from the Data API — or install the SDK (npm install cabalspy-id or pip install cabalspy-id). Then build leaderboards, trader profiles, live activity feeds, copy trading or chart markers on top. Token theses work out of the box with the widget. 03 ##### Is there a SocialFi widget? Yes, two. The login button adds “Login with CabalSpy ID” with two lines of HTML. The theses widget shows token theses from verified holders — with their real position and live PnL — and lets signed-in users write, reply and react. Both are designed in the dashboard. 04 ##### Which chains does the SocialFi API support? Solana, BNB Chain, Base, Ethereum and Robinhood Chain. One login and one API cover all five chains. 05 ##### Do users need to connect a wallet? No. Users prove a wallet with a tiny on-chain payment from it — no wallet connect and no signature prompt. 06 ##### Is there a free plan? Yes. The Free plan includes 50 users with data and 1 request per second; paid plans start at $49 per month. Token theses are included on every plan. #### Related [CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/)[SocialFi API pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id)[KOL API](https://www.cabalspy.xyz/kol-api/)[CabalSpy API SDKs](https://www.cabalspy.xyz/sdks/) #### Add SocialFi to your app. Start free. Create an instance in the API dashboard — sandbox with test users included. [Open the API dashboard](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id)[See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) --- ## KOL & Smart Money API Use Cases — Charts, Leaderboards, Signals | CabalSpy URL: https://www.cabalspy.xyz/use-cases/ > 13 things developers build with the CabalSpy KOL and Smart Money API: chart events, leaderboards, wallet tracking, holder tables, signals, wallet count, widget and more. ### KOL API use cases — what teams build From KOL markers on a chart to a full copy-trading leaderboard: 13 production use cases for **labeled KOL, Smart Money and Whale wallet data**, each with endpoints, code and a step-by-step guide — plus SocialFi with [CabalSpy ID](https://www.cabalspy.xyz/cabalspy-id/). [Get free API key](https://apidashboard.cabalspy.xyz/register)[KOL API](https://www.cabalspy.xyz/kol-api/)[Smart Money API](https://www.cabalspy.xyz/smart-money-api/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Cases #### Everything you can build with the KOL API [KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[KOL LeaderboardRank KOLs by PnL, win rate, trades or volume](https://www.cabalspy.xyz/use-cases/kol-leaderboard/)[KOL Wallet TrackingPnL, win rate, traded tokens and holdings for one wallet](https://www.cabalspy.xyz/use-cases/kol-wallet-tracking/)[KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Supply HoldingShare of a token’s supply held by KOL, Smart Money and Whale wallets](https://www.cabalspy.xyz/use-cases/kol-supply-holding/)[KOL WidgetA live KOL and Smart Money widget, embedded with one iframe](https://www.cabalspy.xyz/use-cases/kol-widget/)[KOL Bundle DetectionFind the side wallets that buy with a KOL in the same block](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/)[PnL CalendarDaily realized PnL per wallet, grouped by month](https://www.cabalspy.xyz/use-cases/pnl-calendar/)[KOL Data LayerAggregate KOL and Smart Money data for analytics and AI](https://www.cabalspy.xyz/use-cases/kol-data-analytics/)[SocialFi LayerVerified users, their wallets and every trade — one login](https://www.cabalspy.xyz/use-cases/socialfi-layer/)[Token ThesesHolders explain why they hold — with their real position and PnL](https://www.cabalspy.xyz/use-cases/token-theses/) #### One API key, every use case. Start free today. 10,000 free credits every month, REST and WebSocket access on all five chains, no credit card. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL Bundle Detection API — Spot Coordinated KOL Buys on Solana | CabalSpy URL: 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. ### KOL Bundle Detection — see the side wallets behind a KOL KOL bundle detection finds **a KOL wallet plus the side wallets that bought a Solana token alongside it in the same block**. Each bundle comes with a confidence score, on-chain proof and a live position for every wallet, over REST or WebSocket. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/Real-Time-Holders-tab-with-balance-and-bundle) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Bundle Detection #### Detect KOL bundles on a token with one request #### What it shows A bundle is a KOL wallet and the side wallets that bought together with it in the same block. KOL bundle detection returns, per token, each detected bundle with the KOL at its center (`kol_wallet`, `kol_profile`), the number of wallets, a `confidence` value, whether it was confirmed as a Jito bundle (`jito_confirmed`), the `proof_type`, the Solana `slot`, a `proof` reference and a `verify_hint` for checking it on chain yourself. Every wallet in the bundle carries a live position: tokens held, bag percentage, supply percentage, amount invested, realized and unrealized PnL, remaining value and entry market cap. Side wallets also carry proof fields such as `adjacent_to_kol`, `same_fee`, `block_index` and `occurrences`, the number of times that wallet has bundled with the KOL. #### How it works For a snapshot, call `GET /v1/bundle` with `blockchain=solana` and the token `mint`. Positions are computed live at request time. If no bundles are detected you get a normal 200 with an empty `bundles` array and the token block, so the endpoint is safe to poll. For live detections, subscribe to the `bundle` stream with a token mint, or `"*"` for every tracked token. A single mint returns an `init` snapshot of its current bundles, followed by `kol_bundle` events as bundles are detected and wallets trade. `mode: "full"` (the default) also sends position updates whenever the market cap moves, which you can throttle with `mc_interval` (1 to 30 seconds); `mode: "events"` sends only detection and trade events and uses the fewest credits. [RESTGET /v1/bundleDetected bundles for a Solana token: KOL, side wallets, confidence, proof and live positions.](https://docs.cabalspy.xyz/bundle)[WebSocketbundle streamAn init snapshot for a token, then kol_bundle events as bundles are detected and wallets trade.](https://docs.cabalspy.xyz/bundle-1) **Supported chains:** Solana only. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/bundle?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&api_key=YOUR_KEY" ``` REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/bundle?${p}`); const { data } = await res.json(); data.bundles.forEach(b => console.log(b.kol_wallet, b.confidence, b.wallet_count)); ``` WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "bundle", token: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", mode: "full", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "init" || msg.event === "kol_bundle") { msg.data.bundles.forEach(b => console.log(b.kol_wallet, "wallets", b.wallet_count)); } }; ``` #### Who builds this - **Trading terminals** — a bundle breakdown on the token page and bundle flags in the holder table - **Alpha and alert bots** — a notification when a KOL buys together with side wallets - **Risk tools** — flag tokens where a KOL’s visible position is only part of the real one - **Analysts** — see which side wallets repeatedly bundle with the same KOL #### Frequently asked questions 01 ##### How do I check if a Solana token is bundled by a KOL? Call GET https://api.cabalspy.xyz/v1/bundle with blockchain=solana and the token mint. The response lists each detected bundle with the KOL wallet, the side wallets, a confidence value, the proof and a live position per wallet. An empty bundles array means no KOL bundle was detected for that token. 02 ##### What is KOL bundle detection? KOL bundle detection identifies coordinated buys in which a KOL wallet and a set of side wallets buy the same token in the same block, a common pattern for insiders riding a KOL call. CabalSpy returns the KOL, the side wallets, a confidence score and on-chain proof for each detected bundle. 03 ##### How can I verify a detected bundle? Each bundle includes the Solana slot, a proof reference, a proof_type, a jito_confirmed flag and a verify_hint for checking it independently on chain. Side wallets carry adjacent_to_kol, same_fee, block_index and occurrences, which show how closely each wallet traded next to the KOL. 04 ##### Which chains does bundle detection support? Solana only. The REST endpoint returns an invalid_parameter error for any other blockchain value, and the bundle WebSocket stream is Solana only as well. 05 ##### How do I keep bundle stream costs low? Each delivered WebSocket event counts against your plan. Subscribe to one token instead of "*", and either set mode to "events" to receive only detection and trade events, or keep mode "full" and set mc_interval between 1 and 30 seconds to limit market cap updates to one per window. #### Go deeper [Cookbook: holders tab with balance and bundle data](https://docs.cabalspy.xyz/Real-Time-Holders-tab-with-balance-and-bundle)[GitHub demo: real-time holder table](https://github.com/CabalSpy/kol-realtime-holder-table)[Bundle Snapshot API reference](https://docs.cabalspy.xyz/bundle)[Bundle stream reference](https://docs.cabalspy.xyz/bundle-1)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[KOL Wallet TrackingPnL, win rate, traded tokens and holdings for one wallet](https://www.cabalspy.xyz/use-cases/kol-wallet-tracking/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Bundle Detection 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Chart Events API — Buys & Sells on Your Chart | CabalSpy URL: 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 Chart Events — KOL buys and sells on every candle A KOL chart API for trading terminals: every buy and sell of a tracked **KOL, Smart Money or Whale wallet** arrives over one WebSocket stream with trader profile, trade value and timestamp — ready to place as a marker on the candle where it happened. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/guides/chart-events) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Chart Events #### Put KOL trades on your chart with one stream #### What it shows KOL chart events are small markers on a price chart at the moment a tracked wallet trades: green for a buy, red for a sell, placed on the candle where it happened. A trader can read a buy marker as a possible entry and a sell marker as an exit, or study the pattern to see how KOLs time their trades. Each event carries what a marker and its tooltip need: the wallet’s public profile (name, avatar, X/Twitter, Telegram), the action (`buy` or `sell`), the trade value in native currency and USD, the trade timestamp, and the wallet’s position after the trade — tokens held, percent of supply and percent of its peak bag still held. #### How it works Open a WebSocket to `wss://stream.cabalspy.xyz` and subscribe to the `tx` stream with a chain, a wallet type and the token address. Every matching trade is delivered as a `position_update` event. Use `transaction.created_at` for the marker time, `transaction.action` for the color and `value.amount_usd` for the size or label. To show KOL, Smart Money and Whale trades together, send one subscribe message per wallet type on the same connection. The stream only delivers trades from the moment you subscribe. To fill the chart with earlier markers, call the REST transactions endpoint for the token once: it returns the individual buys and sells of tracked wallets, newest first, each with `created_at`, `transaction_type`, `value_usd` and the trader profile. You need a chart that accepts markers, for example TradingView Lightweight Charts or the TradingView Charting Library. [WebSockettx stream (position_update)Live buy and sell events of tracked wallets, per chain and wallet type, for all tokens or one token.](https://docs.cabalspy.xyz/transactions-1)[RESTGET /v1/tokens/transactionsPast buys and sells of tracked wallets on one token, newest first, to backfill markers.](https://docs.cabalspy.xyz/transactions) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "tx", blockchain: "solana", type: "kol", token: "*", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "position_update") { const d = msg.data; console.log(d.profile.name, d.transaction.action, d.token.symbol, d.position.bag_pct); } }; ``` WebSocket · subscribe to one token ``` { "op": "subscribe", "stream": "tx", "blockchain": "base", "type": "smart", "token": "0xYourTokenContractAddress" } ``` REST · cURL (backfill) ``` curl "https://api.cabalspy.xyz/v1/tokens/transactions?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50&api_key=YOUR_KEY" ``` #### Who builds this - **Trading terminals** — KOL buy and sell markers on the token chart users already watch - **Charting tools** — a smart money layer on top of TradingView or custom candles - **Copy-trading apps** — show where the wallet you follow entered and exited a token - **Analysts** — study how KOLs time entries and exits against price action #### Frequently asked questions 01 ##### How do I show KOL trades on a chart? Open a WebSocket to wss://stream.cabalspy.xyz with your API key and send a subscribe message with stream "tx", a blockchain, a wallet type (kol, smart or whale) and the token address. Each trade arrives as a position_update event. Add a chart marker at transaction.created_at, green when transaction.action is buy and red when it is sell. 02 ##### Can I add KOL markers to a TradingView chart? Yes. You need a chart you can add markers to, for example TradingView Lightweight Charts or the TradingView Charting Library. CabalSpy delivers the trade events (time, buy or sell, value, trader profile); your code turns each event into a marker on the chart. 03 ##### How do I load KOL trades that happened before the user opened the chart? Call GET https://api.cabalspy.xyz/v1/tokens/transactions with blockchain and mint. It returns the individual buy and sell transactions of tracked wallets on that token, newest first, each with created_at, transaction_type, value and the trader profile. Draw those as markers first, then keep the chart live with the tx WebSocket stream. 04 ##### Which chains does the KOL chart events stream support? The transactions stream accepts the blockchain values solana, bnb, base, eth and rh (Robinhood Chain). Solana tracks KOL, Smart Money and Whale wallets; BNB Chain, Base, Ethereum and Robinhood Chain track KOL and Smart Money. 05 ##### What does the KOL chart API cost? Each delivered WebSocket event costs 1 credit and each REST request costs 10 credits. The free tier includes 10,000 credits per month. Subscribing to a single token instead of the wildcard "*" keeps the number of delivered events low. #### Go deeper [Guide: KOL chart events](https://docs.cabalspy.xyz/guides/chart-events)[Transactions stream reference](https://docs.cabalspy.xyz/transactions-1)[Token transactions API reference](https://docs.cabalspy.xyz/transactions)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[KOL WidgetA live KOL and Smart Money widget, embedded with one iframe](https://www.cabalspy.xyz/use-cases/kol-widget/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Chart Events 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Data API for Analytics & AI | CabalSpy URL: 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. ### KOL Data Layer — aggregate wallet data for analytics and AI A KOL data API for dashboards, models and agents: **trading volume, transaction counts, most traded tokens, top performers and win rates** of tracked KOL, Smart Money and Whale wallets over REST, plus the raw trade flow over WebSocket. Historical data goes back to February 2025. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/analytics) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Data Layer #### Aggregate KOL and Smart Money data with REST and WebSocket #### What it shows Totals instead of single trades. The volume endpoint returns the total trading volume of tracked wallets in a time window of up to 24 hours, in native currency and USD; the count endpoint returns how many transactions they made in the same window. Both accept an optional `mint` to measure one token. The analytics endpoint answers four questions for a period of 6 hours, 1 day, 7 days or 30 days: which tokens are **most traded** (wallet count, volume, net flow, buying pressure), which wallets are **top performers**, what the **win rate** across wallets looks like (including how many wallets traded in the period), and how **volume trends** over time. Token stats, wallet connections and historical cluster signals add per-token and per-wallet context. #### How it works Pick the endpoint by question. For activity in the last hour, call volume or count with `hours=1`. For rankings and trends, call analytics with a `mode` (`most_traded`, `top_performers`, `win_rate` or `volume_trend`) and a `period`. For raw rows, latest returns the most recent transactions and timerange returns every transaction in a window of up to 60 minutes, each with trader profile and position after the trade. For continuous collection, subscribe to the `tx` WebSocket stream and store each `position_update` event as it arrives. For backtesting, signals history returns the cluster signals that would have fired on past days with `triggered_at`, so you can line them up against price data from your own source. Every plan, including the free tier, includes historical data since February 2025. [RESTGET /v1/analyticsMost traded tokens, top performing wallets, win rate stats and volume trend for a period.](https://docs.cabalspy.xyz/analytics)[RESTGET /v1/transactions/volumeTotal volume of tracked wallets in a window of up to 24 hours, native and USD, optionally per token.](https://docs.cabalspy.xyz/volume)[RESTGET /v1/transactions/countNumber of transactions by tracked wallets in a window of up to 24 hours, optionally per token.](https://docs.cabalspy.xyz/count)[RESTGET /v1/transactions/latestMost recent transactions for a chain and wallet type, with trader profile and position after the trade.](https://docs.cabalspy.xyz/latest)[RESTGET /v1/transactions/timerangeAll transactions in a recent window of up to 60 minutes, newest first.](https://docs.cabalspy.xyz/timerange)[RESTGET /v1/tokens/statsAggregate statistics for one token: holder totals by wallet type, flow stats and a per-trader breakdown.](https://docs.cabalspy.xyz/stats)[RESTGET /v1/wallets/connectionsWallets that traded the same tokens as a given wallet over the last 30 days, with an overlap score.](https://docs.cabalspy.xyz/connections)[RESTGET /v1/signals/historyCluster signals that would have fired on past days, for backtesting.](https://docs.cabalspy.xyz/signals-history)[WebSockettx stream (position_update)Every buy and sell of tracked wallets as it happens, with the running position.](https://docs.cabalspy.xyz/transactions-1) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: REST · cURL (volume, last hour) ``` curl "https://api.cabalspy.xyz/v1/transactions/volume?blockchain=solana&type=kol&hours=1&api_key=YOUR_KEY" ``` REST · JavaScript (most traded tokens) ``` const p = new URLSearchParams({ blockchain: "solana", type: "kol", mode: "most_traded", period: "7d", limit: "20", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/analytics?${p}`); const { data } = await res.json(); data.data.forEach(t => console.log(t.rank, t.token_name, t.total_volume)); ``` REST · cURL (signals history) ``` curl "https://api.cabalspy.xyz/v1/signals/history?blockchain=solana&type=kol&days=7&api_key=YOUR_KEY" ``` #### Who builds this - **Analytics dashboards** — KOL volume, activity counts and most traded tokens as ready-made aggregates - **AI agents and models** — labeled wallet activity as input for sentiment analysis and training data - **Quant and research teams** — backtest cluster strategies against historical signals - **Trading terminals** — activity indicators and sparklines without pulling every transaction #### Frequently asked questions 01 ##### What is a KOL data API? A KOL data API returns the on-chain activity of labeled wallets (KOLs, Smart Money and Whales) in a structured form. CabalSpy offers it as REST endpoints for aggregates such as total volume, transaction counts, most traded tokens and win rates, and as WebSocket streams that push every trade as it happens. 02 ##### How do I get the total KOL trading volume for the last hour? Call GET https://api.cabalspy.xyz/v1/transactions/volume with blockchain, type (kol, smart or whale) and hours=1. The response contains volume in native currency, volume_usd and time_window_seconds. Add mint to measure a single token. The window can be up to 24 hours; GET /v1/transactions/count returns the number of transactions for the same window. 03 ##### Which tokens are KOLs trading the most? Call GET https://api.cabalspy.xyz/v1/analytics with mode=most_traded, a blockchain, a wallet type and a period (6h, 1d, 7d or 30d). Each item includes rank, token, the number of tracked wallets that traded it, total volume, total buy and sell, net flow and buying pressure. 04 ##### Can I use CabalSpy data for sentiment analysis or AI training? Yes. The data is labeled by wallet category (KOL, Smart Money, Whale) and available as aggregates over REST and as a live trade stream over WebSocket. Historical data since February 2025 is included in every plan, and the signals history endpoint returns past cluster signals with timestamps for backtesting. 05 ##### How far back does the historical data go? CabalSpy lists historical data since February 2025 on every plan, including the free tier. Per-wallet lifetime trade logs are available through the wallet history endpoint; the aggregate volume and count endpoints cover windows of up to 24 hours and the analytics endpoint covers periods of up to 30 days. #### Go deeper [Analytics API reference](https://docs.cabalspy.xyz/analytics)[Volume API reference](https://docs.cabalspy.xyz/volume)[Signals History API reference](https://docs.cabalspy.xyz/signals-history)[Pricing and credits](https://docs.cabalspy.xyz/pricing)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL LeaderboardRank KOLs by PnL, win rate, trades or volume](https://www.cabalspy.xyz/use-cases/kol-leaderboard/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Data Layer 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Holders API — Real-Time Holder Table | CabalSpy URL: 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 Holders Table — who is in the bag, live The KOL holders API returns every tracked **KOL, Smart Money and Whale wallet** holding a token, with position size, bag percentage, entry market cap and unrealized PnL. Fetch it once over REST or keep it live over a WebSocket stream. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/realtime-holder-table) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Holders Table #### Build a real-time holders tab with one stream #### What it shows A table of the tracked wallets holding a token and how they are doing. Each row carries the wallet’s profile and its position: tokens held, percent of supply, **bag percentage** (how much of the peak holding is still held), invested and remaining value, realized and unrealized PnL, and the market cap at which the wallet first entered. In the full version each row also shows the wallet’s native balance and whether it entered through a coordinated bundle. That is the holders tab known from terminals like Axiom: who is in the token, how large the wallet is, and who is up or down on the position. #### How it works For a live table, subscribe to the `holder` stream with the token address. You first receive an `init` event with a snapshot of every tracked holder, then `holder_update` when a holder trades and `position_update` when the market cap moves and the unrealized numbers change. Positions are computed server side, so you replace a holder’s position with the latest one instead of adding up trades. Use `mode` to control message volume: `full` sends trades plus price-driven updates, `events` sends only real trades. In full mode, `mc_interval` (1 to 30 seconds) limits price updates to one per token per window. To add wallet size and bundle flags, subscribe to the `balance` and `bundle` streams on the same connection and merge the events into rows keyed by wallet address. For a one-off snapshot, the REST holders endpoint returns the holders ranked by amount held. [WebSocketholder stream (init, holder_update, position_update)Snapshot of all tracked holders of a token, then live position updates as they trade and as the market cap moves.](https://docs.cabalspy.xyz/holder)[WebSocketbalance stream (init, balance_update)Native balance of tracked wallets with previous balance and USD value.](https://docs.cabalspy.xyz/balance-1)[WebSocketbundle streamFlags the wallets that entered a Solana token through a coordinated bundle.](https://docs.cabalspy.xyz/bundle-1)[RESTGET /v1/tokens/holdersTracked wallets holding a token, ranked by amount held, each with profile and position.](https://docs.cabalspy.xyz/Holders) **Supported chains:** The holder and balance streams and the REST holders endpoint cover Solana, BNB Chain, Base, Ethereum and Robinhood Chain. The full table that merges holder, balance and bundle data is Solana only, because bundle detection is Solana based; unrealized PnL, remaining value and entry market cap are also Solana-only fields and null on other chains. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "holder", blockchain: "solana", token: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", wallet_types: ["kol", "smart", "whale"], mode: "full", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "init") { console.log("holders", msg.data.holder_count); } else if (msg.event === "holder_update") { const h = msg.data.holder; console.log(h.profile.name, h.position.bag_pct, h.position.unrealized_pnl_usd); } }; ``` WebSocket · throttle price updates ``` { "op": "subscribe", "stream": "holder", "blockchain": "solana", "token": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", "mode": "full", "mc_interval": 5 } ``` REST · cURL ``` curl "https://api.cabalspy.xyz/v1/tokens/holders?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50&api_key=YOUR_KEY" ``` #### Who builds this - **Trading terminals** — the holders tab on every token page, updating without polling - **Token screeners** — a column showing which KOLs and Smart Money wallets are still in - **Copy-trading apps** — see whether the wallets you follow are holding or have sold - **Telegram and Discord bots** — a holders command that lists KOL positions for a token #### Frequently asked questions 01 ##### How do I get the KOL holders of a token? Call GET https://api.cabalspy.xyz/v1/tokens/holders with blockchain and mint. The KOL holders API returns the tracked wallets holding the token, ranked by amount held, each with profile and position (token amount, supply percentage, bag percentage). Pass type (kol, smart or whale) to narrow to one wallet category, or omit it to include all. 02 ##### How do I build a real-time holders tab? Open a WebSocket to wss://stream.cabalspy.xyz and subscribe to the holder stream with the token address. Handle three events: init replaces the table with a full snapshot, holder_update upserts the one holder that just traded, and position_update refreshes positions when the market cap moves. Keep the holders in a map keyed by wallet address and re-render. 03 ##### Does the holders table include unrealized PnL and entry market cap? Yes. The holder stream sends positions with unrealized PnL, remaining value and the market cap at entry. On the REST holders endpoint these live position fields are available on Solana only and are null on other chains; entry market cap is also null for positions opened before entry tracking started. 04 ##### How can I reduce WebSocket credit usage for a holders table? Each delivered event costs 1 credit. Subscribe with mode "events" to receive only real trades, or keep mode "full" and set mc_interval between 1 and 30 seconds to receive at most one price-driven update per token in that window. 05 ##### Which chains does the KOL holder stream support? The holder stream runs on Solana, BNB Chain, Base, Ethereum and Robinhood Chain with an identical event shape. Solana tracks KOL, Smart Money and Whale wallets; BNB Chain, Base, Ethereum and Robinhood Chain track KOL and Smart Money. The combined table with bundle flags is Solana only. #### Go deeper [Cookbook: real-time holders tab](https://docs.cabalspy.xyz/realtime-holder-table)[Cookbook: holders tab with balance and bundle data](https://docs.cabalspy.xyz/Real-Time-Holders-tab-with-balance-and-bundle)[GitHub demo](https://github.com/CabalSpy/kol-realtime-holder-table)[Holder stream reference](https://docs.cabalspy.xyz/holder)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Supply HoldingShare of a token’s supply held by KOL, Smart Money and Whale wallets](https://www.cabalspy.xyz/use-cases/kol-supply-holding/)[KOL Bundle DetectionFind the side wallets that buy with a KOL in the same block](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/)[KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Holders Table 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Leaderboard API — Rank by PnL & Win Rate | CabalSpy URL: 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 Leaderboard API — who is winning right now One endpoint returns a ranked list of **KOL, Smart Money and Whale wallets** for any period — each with profile, realized PnL, win rate, trade count and volume. The data behind copy-trading boards like Axiom’s Vision tab. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/build-a-leaderboard-like-axiom-vision) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Leaderboard #### Build a KOL leaderboard with one API call #### What it shows A ranked list of tracked wallets for a period you choose — **6 hours, 1 day, 7 days or 30 days**. Every entry carries the trader’s public profile (name, avatar, X/Twitter, Telegram) and period statistics: buy and sell volume, realized PnL, average hold time and a win rate breakdown showing how many closed positions were winners. Show the top traders as a podium and the rest in a sortable table. Your users get a discovery page for the best wallets to follow or copy — and a simple answer to the question every trader asks: who is winning right now? #### How it works Call the leaderboard endpoint with a chain, a wallet type (`kol`, `smart` or `whale`) and a period. Without a `limit` you get the full ranking in one response; for large boards, set `limit` and page with the returned `next_cursor`. The leaderboard is served from a permanently cached, WebSocket-driven store, so reads are fast and consistent. Sorting by PnL, win rate, trades or volume happens instantly on the client, because every entry already includes all four metrics. [RESTGET /v1/wallets/leaderboardRanked wallets for a chain, wallet type and period, each with profile, period stats and win rate.](https://docs.cabalspy.xyz/leaderboard) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/wallets/leaderboard?blockchain=solana&type=kol&period=7d&limit=20&api_key=YOUR_KEY" ``` REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", type: "kol", period: "7d", limit: "20", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/wallets/leaderboard?${p}`); const { data } = await res.json(); data.leaderboard.forEach((w, i) => console.log(`${i + 1}. ${w.profile.name || w.wallet} vol ${w.period_stats.total_volume}`)); ``` #### Who builds this - **Trading terminals** — a “Top traders” tab that keeps users inside your product - **Copy-trading apps** — a shortlist of verified wallets to follow, ranked by real PnL - **Telegram and Discord bots** — a daily “Top KOLs this week” post - **Analysts** — spot who is rotating capital and which traders are consistently profitable #### Frequently asked questions 01 ##### How do I build a KOL leaderboard? Call GET https://api.cabalspy.xyz/v1/wallets/leaderboard with blockchain, type (kol, smart or whale) and period (6h, 1d, 7d or 30d). The response is a ranked list where each wallet includes its profile, period stats and win rate — enough to render a podium and a sortable table without further calls. 02 ##### Which metrics can I rank KOLs by? The API returns the list sorted by trading volume and includes realized PnL, win rate, trade count and volume for every wallet, so you can re-sort by any of them on the client instantly. 03 ##### Which chains does the KOL leaderboard support? Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana offers KOL, Smart Money and Whale leaderboards; BNB Chain, Base, Ethereum and Robinhood Chain offer KOL and Smart Money. 04 ##### Is there a ready-made example? Yes. The CabalSpy docs include a step-by-step cookbook for a leaderboard like Axiom Vision, and an open-source demo is available on GitHub. #### Go deeper [Cookbook: build a trader leaderboard](https://docs.cabalspy.xyz/build-a-leaderboard-like-axiom-vision)[GitHub demo](https://github.com/CabalSpy/Leaderboard-Demo)[Leaderboard API reference](https://docs.cabalspy.xyz/leaderboard)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Wallet TrackingPnL, win rate, traded tokens and holdings for one wallet](https://www.cabalspy.xyz/use-cases/kol-wallet-tracking/)[PnL CalendarDaily realized PnL per wallet, grouped by month](https://www.cabalspy.xyz/use-cases/pnl-calendar/)[KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Leaderboard 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Signals API — Cluster Buy Alerts for Bots | CabalSpy URL: 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 Signals API — alerts when KOLs buy the same token The KOL signals API fires an **entry signal** when enough tracked KOL or Smart Money wallets buy the same token, and an **exit signal** when they leave. You set the thresholds; delivery is a WebSocket stream or a REST snapshot. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/build-a-signal-for-wallet-cluster-buying) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Signal Service #### Turn KOL cluster buys into alerts you can act on #### What it shows A KOL signals API reports coordinated buying. When a group of KOL or Smart Money wallets buys the same token inside a short window, that is a **cluster**. Each signal names the token, the wallets in the cluster with their profiles, how much they invested in native currency and USD, and the trade that triggered it. On the live stream every signal is marked `entry` or `exit` and carries the token’s live market cap plus, per wallet, the entry market cap, bag percentage and unrealized PnL. The REST snapshot adds a `signal_strength` of strong or medium and the time span between the first and latest buy. #### How it works For live alerts, open the WebSocket and subscribe to the `signal` stream with a chain, a token (`"*"` for all tokens or one address) and a rule block per wallet type. In a `kol` or `smart` block, `entry_at` lists the wallet counts that fire an entry (up to 3 values), `exit_at` lists the remaining holder counts that fire an exit (up to 2 values) and `min_buy` is the smallest buy that counts, in the chain’s native currency. With both blocks set, the entry gate is an AND: every type must reach its own count. Optional filters narrow the cluster: `min_win_rate`, `include_wallets`, `exclude_wallets`, `min_token_age` and `max_token_age` (hours since the first tracked buy). For a signals page you refresh on a schedule, call `GET /v1/signals` with `mode=cluster` and tune it with `min_wallets` (default 3), `min_value` and `hours` (default 1). `GET /v1/signals/history` returns the cluster signals that would have fired on past days, for backtesting. [WebSocketsignal streamLive entry and exit signals with your own thresholds per wallet type, for all tokens or one token.](https://docs.cabalspy.xyz/signal)[RESTGET /v1/signalsSnapshot of current signals in cluster, entry or exit mode for a chain, wallet type and time window.](https://docs.cabalspy.xyz/signals)[RESTGET /v1/signals/historyCluster signals that would have fired on past days, each with day, wallet count and amount invested.](https://docs.cabalspy.xyz/signals-history) **Supported chains:** Solana, BNB Chain, Base, Ethereum and Robinhood Chain. The signal stream covers KOL and Smart Money rules; Smart Money is not available on Ethereum. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "signal", blockchain: "solana", token: "*", kol: { min_buy: 0.5, entry_at: [3, 5], exit_at: [1] }, min_win_rate: 50, })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "signal") { const d = msg.data; console.log(d.signal_kind, d.token.symbol, "wallets", d.cluster.qualifying_total); } }; ``` REST · cURL ``` curl "https://api.cabalspy.xyz/v1/signals?blockchain=solana&type=kol&mode=cluster&min_wallets=3&hours=1&api_key=YOUR_KEY" ``` #### Who builds this - **Telegram and Discord bots** — post an alert the moment a third or fifth KOL buys a token - **Alpha bots and AI agents** — use entry and exit signals as a trigger, gated by win rate and token age - **Trading terminals** — a signals page seeded over REST and updated live from the stream - **Quants and analysts** — backtest a cluster strategy against the signals history endpoint #### Frequently asked questions 01 ##### How do I get alerts when KOLs buy the same token? Connect to wss://stream.cabalspy.xyz with your API key and subscribe to the signal stream with a chain, token "*" and a kol block such as { "entry_at": [3], "exit_at": [1] }. CabalSpy then pushes an entry signal when the third qualifying KOL wallet buys a token and an exit signal when only one is still holding. 02 ##### What is a KOL signals API? A KOL signals API turns the trades of labeled KOL and Smart Money wallets into events. CabalSpy detects clusters, meaning several tracked wallets buying the same token within a time window, and delivers them as live entry and exit signals over WebSocket or as a snapshot from GET /v1/signals. 03 ##### Can I require both KOLs and Smart Money before a signal fires? Yes. Send both a kol and a smart block when you subscribe to the signal stream. The entry gate is then an AND: each configured wallet type must reach its own entry_at count before the entry signal fires. You can also add min_win_rate so only wallets above a lifetime win rate count. 04 ##### Can I backtest KOL cluster signals? Yes. GET https://api.cabalspy.xyz/v1/signals/history with blockchain, type and days returns the cluster signals that would have fired on past days, each with the token, wallet count, amount invested and triggered_at timestamp, so you can compare them with price history from your own source. 05 ##### How are signals billed? A REST call to the signals endpoint is one request, which costs 10 credits. On the WebSocket stream each delivered signal deducts a fixed number of credits that is higher than a plain event, because a signal aggregates a whole cluster. The free tier includes 10,000 credits per month. #### Go deeper [Cookbook: build a signal service](https://docs.cabalspy.xyz/build-a-signal-for-wallet-cluster-buying)[Signal stream reference](https://docs.cabalspy.xyz/signal)[Signals API reference](https://docs.cabalspy.xyz/signals)[Signals history reference](https://docs.cabalspy.xyz/signals-history)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Bundle DetectionFind the side wallets that buy with a KOL in the same block](https://www.cabalspy.xyz/use-cases/kol-bundle-detection/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[KOL Data LayerAggregate KOL and Smart Money data for analytics and AI](https://www.cabalspy.xyz/use-cases/kol-data-analytics/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Signal Service 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Supply Holding API — % of Token Supply | CabalSpy URL: 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 Supply Holding — how much is in smart hands KOL supply holding is the **percent of a token’s supply held by tracked KOL, Smart Money and Whale wallets**, per wallet and combined. Every trade event carries the wallet’s new supply percentage and bag percentage, so the number moves as they buy and sell. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/build-a-supply-and-bag-holdings-badge) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Supply Holding #### Measure KOL supply holding from one call and one stream #### What it shows KOL supply holding answers how much of a token sits with wallets you follow. Each tracked holder has a `supply_pct` (percent of supply currently held) and a `bag_pct` (percent of its peak holding still held). Summing `supply_pct` across holders gives the share of supply in tracked hands, which you can split by wallet type: KOL, Smart Money and Whale. A high or rising total means the token is concentrating in tracked wallets. The bag percentage shows the other side: a wallet whose `supply_pct_peak` is far above its current `supply_pct` has been selling. #### How it works Start with a snapshot: `GET /v1/tokens/holders` with `blockchain` and `mint` returns every tracked holder of the token, sorted by amount held, each with `holdings.supply_pct`, `supply_pct_peak` and `bag_pct`, plus a `total_holders` count by type. One pass over the list gives the combined total, the breakdown by wallet type and a per-wallet ranking. To keep it live, subscribe to the transactions stream (`stream: "tx"`) for the token. Every buy or sell delivers a `position_update` event whose `position` block contains `supply_pct`, `bag_pct`, the previous values and the deltas (`delta_supply_pct`, `delta_bag_pct`). Update the wallet’s entry and re-sum. The holder stream carries the same `supply_pct` per holder if you prefer full holder updates. [WebSockettransactions stream (tx)A position_update event per trade with the wallet’s supply_pct and bag_pct after the trade and the change.](https://docs.cabalspy.xyz/transactions-1)[RESTGET /v1/tokens/holdersEvery tracked holder of a token with supply_pct, supply_pct_peak and bag_pct, plus holder counts by type.](https://docs.cabalspy.xyz/Holders)[WebSocketholder streamLive holder positions for a token, including supply_pct per holder on every update.](https://docs.cabalspy.xyz/holder) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/tokens/holders?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50&api_key=YOUR_KEY" ``` WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "tx", blockchain: "solana", type: "kol", token: "*", })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "position_update") { const d = msg.data; console.log(d.profile.name, d.transaction.action, d.token.symbol, d.position.bag_pct); } }; ``` #### Who builds this - **Trading terminals** — a “12.4% held by KOLs” badge on the token page - **Token screeners** — filter or sort tokens by supply concentration in tracked wallets - **Risk and alert bots** — warn when a large holder’s bag percentage drops - **Analysts** — compare KOL, Smart Money and Whale shares of a token’s supply #### Frequently asked questions 01 ##### How do I find out what percent of a token’s supply KOLs hold? Call GET https://api.cabalspy.xyz/v1/tokens/holders with blockchain and mint. Each tracked holder in the response has holdings.supply_pct, the percent of supply it currently holds. Add those values up for the combined KOL supply holding, or group them by wallet type for separate KOL, Smart Money and Whale shares. 02 ##### What is the difference between supply percentage and bag percentage? supply_pct is the percent of the token’s total supply a wallet holds now. bag_pct is the percent of that wallet’s own peak holding it still holds. A wallet at 0.5% supply and 40% bag has sold more than half of its largest position. 03 ##### Does the supply holding number update in real time? Yes. The CabalSpy transactions stream sends a position_update event for every buy or sell by a tracked wallet, including supply_pct and bag_pct after the trade and the deltas. Update that wallet in your list and re-sum to keep the total live without polling. 04 ##### Which chains support KOL supply holding? Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana tracks KOL, Smart Money and Whale wallets; BNB Chain, Base, Ethereum and Robinhood Chain track KOL and Smart Money. #### Go deeper [Cookbook: supply held by wallets](https://docs.cabalspy.xyz/build-a-supply-and-bag-holdings-badge)[Transactions stream reference](https://docs.cabalspy.xyz/transactions-1)[Holders API reference](https://docs.cabalspy.xyz/Holders)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Supply Holding 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Wallet Count API — Live Count per Token | CabalSpy URL: 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 Wallet Count — a live KOL badge for every token The KOL count API puts one number next to a token: **how many tracked KOL wallets hold it right now**. A WebSocket stream pushes the KOL wallet count as wallets buy; REST endpoints give a number on demand. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/count-1) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Wallet Count #### Add a KOL count badge with one subscription #### What it shows The KOL wallet count is the number of distinct tracked KOL wallets holding a token. Shown as a badge in a token list or on a token page, it works as an activity indicator: a rising count means more KOLs are entering the token. Two related numbers are available over REST. The transactions count returns how many trades tracked wallets of one type (`kol`, `smart` or `whale`) made in a time window of up to 24 hours. The token holders endpoint returns a `total_holders` block with `kol_count`, `smart_count`, `whale_count` and `still_holding_count` for one token. #### How it works For a live badge, open the WebSocket and subscribe to the `count` stream with a chain and a token: `"*"` for every token or one mint or contract address. Each time a tracked KOL wallet buys, you receive a `wallet_count` event with `mint` and `kol_count`. The stream is not split by wallet type; it always reports the KOL wallet count. One connection can feed a whole token list: keep the latest count per mint and update the matching badge. For a number on demand, call `GET /v1/transactions/count` with `blockchain`, `type` and a window built from `seconds`, `minutes` and `hours`, optionally filtered to one token with `mint`. It returns only the count, not the transactions. Note the difference: this endpoint counts trades in the window, while the stream counts distinct KOL wallets holding the token. [WebSocketcount streamLive wallet_count events with the number of distinct KOL wallets holding a token, for all tokens or one.](https://docs.cabalspy.xyz/Count)[RESTGET /v1/transactions/countHow many transactions tracked wallets of one type made in a window of up to 24 hours, optionally per token.](https://docs.cabalspy.xyz/count)[RESTGET /v1/tokens/holdersTracked holders of a token plus total_holders with KOL, Smart Money and Whale counts.](https://docs.cabalspy.xyz/Holders) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: WebSocket · JavaScript ``` const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY"); ws.onopen = () => { ws.send(JSON.stringify({ op: "subscribe", stream: "count", blockchain: "solana", token: "*" })); }; ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.event === "wallet_count") { console.log(msg.data.mint, "kol count", msg.data.kol_count); } }; ``` REST · cURL ``` curl "https://api.cabalspy.xyz/v1/transactions/count?blockchain=solana&type=kol&hours=1&api_key=YOUR_KEY" ``` REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", type: "kol", hours: "1", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/transactions/count?${p}`); const { data } = await res.json(); console.log("count", data.count); ``` #### Who builds this - **Trading terminals** — a “5 KOLs” badge on every row of a token list or pulse page - **Token pages and screeners** — a heat indicator that ticks up as KOLs enter - **Bots and agents** — a cheap trigger before pulling heavier holder or signal data - **Dashboards** — activity sparklines from trade counts over the last minutes or hours #### Frequently asked questions 01 ##### How do I see how many KOLs hold a token? Subscribe to the CabalSpy count stream at wss://stream.cabalspy.xyz with { "op": "subscribe", "stream": "count", "blockchain": "solana", "token": "" }. Every wallet_count event contains kol_count, the number of distinct tracked KOL wallets holding that token. For a one-off number over REST, GET /v1/tokens/holders returns total_holders with kol_count, smart_count and whale_count. 02 ##### What does the KOL count API return? The WebSocket count stream returns the token mint or contract address and kol_count, the number of distinct KOL wallets holding it. The REST endpoint GET /v1/transactions/count returns count, the number of transactions tracked wallets made in the requested window, and time_window_seconds. 03 ##### Can I count Smart Money or Whale wallets too? The live count stream always reports the KOL wallet count and is not split by wallet type. For Smart Money and Whale numbers use REST: GET /v1/transactions/count accepts type kol, smart or whale for trade counts, and GET /v1/tokens/holders returns kol_count, smart_count and whale_count for a token. 04 ##### Should I use REST or WebSocket for a KOL badge? Use the WebSocket count stream when the badge should update the moment a KOL buys. Poll the REST count when a slightly stale number is fine; the CabalSpy cookbook suggests a 30 second interval for an activity badge. You can combine both: seed the badge over REST on first paint, then let the stream update it. 05 ##### How much does a live KOL count cost? Each REST request costs 10 credits and each delivered WebSocket event costs 1 credit. A wildcard subscription on a busy chain produces many events, so subscribe only to the tokens you display. The free tier includes 10,000 credits per month. #### Go deeper [Cookbook: live wallet count badge](https://docs.cabalspy.xyz/count-1)[Count stream reference](https://docs.cabalspy.xyz/Count)[Transactions count API reference](https://docs.cabalspy.xyz/count)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Supply HoldingShare of a token’s supply held by KOL, Smart Money and Whale wallets](https://www.cabalspy.xyz/use-cases/kol-supply-holding/)[KOL Signal ServiceEntry and exit alerts when several KOLs buy the same token](https://www.cabalspy.xyz/use-cases/kol-signals/)[KOL WidgetA live KOL and Smart Money widget, embedded with one iframe](https://www.cabalspy.xyz/use-cases/kol-widget/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Wallet Count 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL & Smart Money Wallet Tracker API — PnL, Win Rate, Holdings | CabalSpy URL: 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 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom) 5,500+ 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.](https://docs.cabalspy.xyz/tracker)[RESTGET /v1/wallets/holdingsCurrent on-chain token balances of a tracked wallet, including the native coin.](https://docs.cabalspy.xyz/holdings)[RESTGET /v1/wallets/historyLifetime stats, per-token overview and a paginated trade log, newest first.](https://docs.cabalspy.xyz/history)[RESTGET /v1/wallets/lookupCheck whether an address is tracked and return its name, socials, wallet type and chain.](https://docs.cabalspy.xyz/lookup) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (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 01 ##### 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. 02 ##### 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. 03 ##### 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. 04 ##### 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. 05 ##### 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 [Cookbook: build a wallet tracker](https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom)[GitHub demo](https://github.com/CabalSpy/Wallet-Tracker-Demo)[Tracker API reference](https://docs.cabalspy.xyz/tracker)[Guide: KOL wallet tracking](https://docs.cabalspy.xyz/guides/kol-wallet-tracking)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [PnL CalendarDaily realized PnL per wallet, grouped by month](https://www.cabalspy.xyz/use-cases/pnl-calendar/)[KOL LeaderboardRank KOLs by PnL, win rate, trades or volume](https://www.cabalspy.xyz/use-cases/kol-leaderboard/)[KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOL Widget — Embeddable KOL & Smart Money Widget, One iframe | CabalSpy URL: 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 Widget — live KOL activity, no frontend work The KOL widget is a **single iframe** for your trading terminal or website. It shows how many KOL and Smart Money wallets are involved in a token as a live bubble map. CabalSpy handles the data, styling and live updates. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/widget-i-frame) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · KOL Widget #### Embed a KOL widget with one line of code #### What it shows The KOL widget renders a live bubble map of labeled wallet activity for an address: the KOL and Smart Money wallets involved, animating as new buys and sells arrive. Users see at a glance how many labeled wallets are in a token without leaving your page. On Solana the widget shows KOL, Smart Money and Whale rings; on the other chains it shows KOL and Smart Money rings. Values are denominated in the chain’s native currency. #### How it works There are no API calls to wire up. The widget is configured entirely through query parameters on the `/widget` URL: `address` (required, the token address) and `chain`. Always set `chain` explicitly, because EVM chains share the `0x…` address format and cannot be told apart from the address alone. Once loaded, the widget keeps itself current over a WebSocket. The widget fills the iframe, so you size the iframe. A roughly square area (1:1 to 1:1.2) works best, with at least about 360 px of height on mobile. The widget only renders on approved domains: send CabalSpy the hostnames you embed on and they are added to the allow-list, subdomains included. Until then the iframe’s data calls return `403`; opening the widget URL directly in a browser tab always works for testing. Widget plans are priced by domains and daily users: Starter at $199 per month (about 250 daily users, one domain), Pro at $499 per month (about 1,000 daily users, up to three domains) and Enterprise with custom limits and unlimited domains. See [pricing](https://www.cabalspy.xyz/pricing/). [Widgetwidget.cabalspy.xyz/widgetOne iframe URL with address and chain query parameters. Data, styling and live updates are handled by CabalSpy.](https://docs.cabalspy.xyz/widget-i-frame) **Supported chains:** Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana shows KOL, Smart Money and Whale rings; the other chains show KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: Embed · iframe ``` ``` Embed · responsive wrapper ```
``` #### Who builds this - **Trading terminals** — labeled wallet activity on the token page without building a frontend for it - **Token and community sites** — a live view of the KOLs and Smart Money in the token - **Dashboards and screeners** — a drop-in panel next to the chart - **Teams without frontend capacity** — KOL data in the product the same day, no API integration #### Frequently asked questions 01 ##### How do I embed a KOL widget on my website? Add one iframe that points to https://widget.cabalspy.xyz/widget with the query parameters address and chain, for example ?address=...&chain=SOL. Before it renders on your site, your domain has to be on CabalSpy’s allow-list, so send the hostnames you embed on. No API key handling or frontend code is needed. 02 ##### What does the KOL widget show? A live bubble map of labeled wallet activity: the KOL and Smart Money wallets involved, updated over a WebSocket as buys and sells arrive. On Solana it shows KOL, Smart Money and Whale rings; on the other chains KOL and Smart Money rings. 03 ##### Which chains does the KOL widget support? Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Set the chain parameter explicitly, because EVM chains share the 0x address format. Chain values include SOL, BNB, BASE and RH (Robinhood). 04 ##### How much does the KOL widget cost? Widget Starter costs $199 per month for about 250 daily users on one domain. Widget Pro costs $499 per month for about 1,000 daily users on up to three domains and adds priority support. Enterprise has custom pricing with unlimited domains and custom user limits. A daily user is a unique visitor who loads the widget on your site in a day. 05 ##### Why is the widget blank or returning 403? The embedding domain is not on the allow-list yet, or the address has no tracked wallets. Confirm the domain was approved and that address matches the chain parameter. Opening the widget URL directly in a browser tab always works, which is useful for testing. #### Go deeper [Widget iframe guide](https://docs.cabalspy.xyz/widget-i-frame)[Widget pricing](https://docs.cabalspy.xyz/get-started-1)[KOL Widget overview](https://docs.cabalspy.xyz/guides/widget)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Wallet CountA live number: how many KOL wallets are in a token](https://www.cabalspy.xyz/use-cases/kol-wallet-count/)[KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build KOL Widget 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Wallet PnL Calendar API — Daily PnL for KOL & Smart Money Wallets | CabalSpy URL: 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. ### PnL Calendar API — a trader’s consistency at a glance The PnL calendar API returns a wallet’s **realized PnL day by day, grouped by month**. Each day carries PnL, volume, buy and sell counts and tokens traded; each month adds totals and the longest winning and losing streaks. [Get free API key](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by Use Case · PnL Calendar #### Render a wallet PnL calendar from one API call #### What it shows A calendar with one cell per day: green for a winning day, red for a losing one. Every day includes realized PnL in native currency and USD, traded volume, buy and sell transaction counts, total buy and sell value, and the number of distinct tokens traded. Every month comes with a summary: realized PnL, volume, transaction counts, tokens traded and the longest positive and negative day streaks. That makes consistency visible quickly — a wall of green is a steady winner, a scattered calendar is a gambler. #### How it works Call the calendar endpoint with `blockchain` and `address`. The response contains `months`, an array of all months oldest first. Each entry has a `dates` array with the days and a `month` object with the monthly summary, so you can render the grid without further aggregation. Day dates use the format `DD-MM-YY`, for example `04-07-26`. The current month updates continuously and is also returned at the top level as `dates` and `month` for convenience. The response includes the wallet’s profile, so the calendar header needs no second request. [RESTGET /v1/wallet/pnl_calendarDay by day realized PnL for a wallet, grouped by month, with monthly summary and streaks.](https://docs.cabalspy.xyz/pnl-calender) **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, Ethereum and Robinhood Chain have KOL and Smart Money. #### Quick start Get a free key from the [API dashboard](https://apidashboard.cabalspy.xyz/register) (10,000 credits per month, no credit card), then: REST · cURL ``` curl "https://api.cabalspy.xyz/v1/wallet/pnl_calendar?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&api_key=YOUR_KEY" ``` REST · JavaScript ``` const p = new URLSearchParams({ blockchain: "solana", address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW", api_key: "YOUR_KEY", }); const res = await fetch(`https://api.cabalspy.xyz/v1/wallet/pnl_calendar?${p}`); const { data } = await res.json(); data.months.forEach(month => month.dates.forEach(day => console.log(day.date, day.realized_pnl))); ``` #### Who builds this - **Trading terminals** — a calendar heatmap on every wallet profile page - **Copy-trading apps** — show how consistent a trader is before users follow them - **Portfolio and journal tools** — daily and monthly realized PnL without computing it from raw trades - **Telegram and Discord bots** — a monthly PnL summary with streaks for a wallet #### Frequently asked questions 01 ##### How do I build a wallet PnL calendar? Call GET https://api.cabalspy.xyz/v1/wallet/pnl_calendar with blockchain and address. The PnL calendar API returns a months array, oldest first; each month has a dates array with one entry per day (date, realized_pnl, realized_pnl_usd, volume, buy_txn, sell_txn, tokens_traded) and a month summary. Render one cell per day and color it by the sign of realized_pnl. 02 ##### What data does the PnL calendar return for each day? Each day contains the date in DD-MM-YY format, realized PnL in native currency and USD, volume, buy, sell and total transaction counts, total buy and sell value in native currency and USD, and the number of distinct tokens traded. 03 ##### Does the PnL calendar include winning and losing streaks? Yes. Each month summary includes positive_streak and negative_streak, the longest winning and losing day streaks in that month, together with the month’s realized PnL, volume, transaction counts and tokens traded. 04 ##### Is the PnL realized or unrealized? The calendar shows realized PnL only: profit and loss from positions the wallet has sold. Open positions and their unrealized PnL are not part of the calendar. 05 ##### How many API calls does a PnL calendar need? One. A single REST request returns all months with their days and summaries, and costs 10 credits. The free tier includes 10,000 credits per month. #### Go deeper [Cookbook: build a wallet tracker (with PnL calendar)](https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom)[PnL Calendar API reference](https://docs.cabalspy.xyz/pnl-calender)[Guide: PnL calendar](https://docs.cabalspy.xyz/guides/pnl-calendar)[KOL API overview](https://www.cabalspy.xyz/kol-api/) #### Related use cases [KOL Wallet TrackingPnL, win rate, traded tokens and holdings for one wallet](https://www.cabalspy.xyz/use-cases/kol-wallet-tracking/)[KOL LeaderboardRank KOLs by PnL, win rate, trades or volume](https://www.cabalspy.xyz/use-cases/kol-leaderboard/)[KOL Data LayerAggregate KOL and Smart Money data for analytics and AI](https://www.cabalspy.xyz/use-cases/kol-data-analytics/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build PnL Calendar 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](https://apidashboard.cabalspy.xyz/register)[Read the docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## SocialFi Layer — Login, Verified Wallets & Live Trades | CabalSpy URL: 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. ### SocialFi Layer — your users, verified and live With **CabalSpy ID** your users sign in once and bring their verified wallets with them. Every trade of those wallets is tracked live on Solana, BNB Chain, Base, Ethereum and Robinhood Chain — you build the social features on top. [Start free](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id) Use Case · SocialFi Layer #### Build a social layer with CabalSpy ID #### What it shows A SocialFi layer connects who your users are with what they actually trade. CabalSpy ID gives you each user’s X profile, their verified wallets, a reviewed KOL badge where granted, and full trading stats — realized PnL, win rate, trades, holdings and a PnL calendar. On top of that you build the social experience: **leaderboards** of your own community, **live activity feeds**, **copy trading** and following based on tracked performance, and **trader profiles** inside your app. #### How it works Users sign in with **“Login with CabalSpy ID”** — standard OpenID Connect (authorization code + PKCE). They prove each wallet with a tiny on-chain payment from it: no wallet connect, no signature prompt. Every verified wallet is tracked automatically, so there is no indexing on your side. Your backend reads the data from the Data API at `api-id.cabalspy.xyz/v1`, receives every trade of your users over the WebSocket stream (Pro plan and up) and gets webhooks such as `wallet.verified` and `kol.granted`. Use the same API key as the CabalSpy API with the “CabalSpy ID” toggle enabled. A key sees its own instance: the users who signed in to your apps, within your plan’s limit. See [pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id). [WidgetLogin with CabalSpy IDTwo lines of HTML, designed in the dashboard’s button builder. OpenID Connect with PKCE.](https://docs.cabalspy.xyz/cabalspy-id)[RESTGET /v1/profileX profile, verified wallets and KOL badge of a user.](https://docs.cabalspy.xyz/cabalspy-id)[RESTGET /v1/wallets/trackerStats, realized PnL, win rate, PnL chart and trades of a verified wallet.](https://docs.cabalspy.xyz/cabalspy-id)[RESTGET /v1/wallets/leaderboardYour users ranked by volume, PnL, win rate or trades — per chain and period.](https://docs.cabalspy.xyz/cabalspy-id)[WebSocketwss://api-id.cabalspy.xyz/v1/streamEvery trade of your users, live (Pro plan and up).](https://docs.cabalspy.xyz/cabalspy-id) **Supported chains:** Solana, BNB Chain, Base, Ethereum and Robinhood Chain. #### Quick start Create a CabalSpy ID instance in the [API dashboard](https://apidashboard.cabalspy.xyz/csid) (free plan, sandbox with test users), then: Login button · HTML ```
``` Data API · JavaScript SDK ``` import { CabalSpyID } from 'cabalspy-id'; const csid = new CabalSpyID({ apiKey: process.env.CABALSPY_API_KEY }); // The person who just signed in: look them up by the sub of their ID token const profile = await csid.profile({ csid_id: claims.sub }); // Your users ranked by PnL const board = await csid.leaderboard({ blockchain: 'solana', period: '7d', sort: 'pnl_usd', limit: 25 }); ``` #### Who builds this - **Trading terminals and DEXs** — leaderboards, trader profiles and copy trading from verified users - **Launchpads and communities** — a live feed of what members trade and who is really holding - **Bots and wallets** — one login that brings verified wallets and stats with it - **Games and any other app** — social features backed by real on-chain activity #### Frequently asked questions 01 ##### What is a SocialFi layer? A layer that connects social identity with real on-chain activity. With CabalSpy ID your users sign in once; you get their profile, verified wallets and every trade, and build social features on top. 02 ##### Do I need my own wallet indexing? No. Every verified wallet is tracked by CabalSpy. Stats, PnL, trades, holdings and leaderboards come ready from the Data API — the same numbers as the CabalSpy API. 03 ##### Do users have to connect a wallet? No. Users prove a wallet with a tiny on-chain payment from it — no wallet connect and nothing to sign. 04 ##### Is there a free plan? Yes. The Free plan includes 50 users with data and 1 request per second; paid plans start at $49 per month. Above your limit sign-in keeps working, but extra users arrive without data until you upgrade. #### Go deeper [CabalSpy ID docs](https://docs.cabalspy.xyz/cabalspy-id)[CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/)[SocialFi API & SDKs](https://www.cabalspy.xyz/socialfi-api/)[SocialFi API pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id)[CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/) #### Related use cases [Token ThesesHolders explain why they hold — with their real position and PnL](https://www.cabalspy.xyz/use-cases/token-theses/)[KOL LeaderboardRank KOLs by PnL, win rate, trades or volume](https://www.cabalspy.xyz/use-cases/kol-leaderboard/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build SocialFi Layer into your product. Start free today. Free CabalSpy ID plan with sandbox and test users. Token theses included on every plan. [Open the API dashboard](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id)[See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) --- ## Token Theses — Holder Theses with Real PnL, Widget & API | CabalSpy URL: 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. ### Token Theses — why holders hold, proven on-chain Holders explain why they hold a token — and every thesis shows the author’s **real, on-chain verified position and live PnL**, marked “Sold” when they exit. Embed the widget or build your own UI with the API. [Start free](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id/theses) Use Case · Token Theses #### Add proven theses with CabalSpy ID #### What it shows A thesis is a short opinion on a token, optionally tagged bullish or bearish. Only holders post theses: one of the author’s verified wallets bought the token and still holds it. Each thesis shows what the author bought and their live PnL now — or “Sold” once they exit. Anyone signed in can reply, like and react with emojis. Reports and moderation are included. By default a token shows theses from all platforms, so there is content from day one; you can switch to theses from your own instance only. #### How it works **Widget:** paste two lines and design it in the dashboard — colors, font, radius, theme, sort and reach — with a live preview. Users signed in with CabalSpy ID write directly in the widget. **Your own UI:** read theses for any token through the Data API, post from your own button in the user’s name (the user signs in with the `thesis` scope), and subscribe to the live theses stream for any number of tokens — for example to show thesis markers on your chart. The `thesis.created` webhook tells your backend about new theses. Token theses are included on every plan, including Free. See [pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) or [try it live](https://id.cabalspy.xyz/try/thesis). [Widgetdata-csid-thesisThesis widget per token, designed in the dashboard. Signed-in users write directly.](https://docs.cabalspy.xyz/cabalspy-id/theses)[RESTGET /v1/thesesTheses of a token, sorted and filtered by stance.](https://docs.cabalspy.xyz/cabalspy-id/theses)[RESTPOST /v1/thesesPost a thesis in the name of one of your users.](https://docs.cabalspy.xyz/cabalspy-id/theses)[WebSocketTheses streamNew theses, replies and reactions live — for any number of tokens.](https://docs.cabalspy.xyz/cabalspy-id/theses) **Supported chains:** Solana, BNB Chain, Base, Ethereum and Robinhood Chain. #### Quick start Create a CabalSpy ID instance in the [API dashboard](https://apidashboard.cabalspy.xyz/csid) (free plan, sandbox with test users), then: Thesis widget · HTML ```
``` Data API · JavaScript SDK ``` const list = await csid.listTheses({ blockchain: 'solana', mint, sort: 'new' }); const counts = await csid.thesisSummary({ blockchain: 'solana', mint }); // theses, bull, bear, authors, token const { can_post, reason } = await csid.thesisEligibility({ blockchain: 'solana', mint, csid_id: claims.sub }); if (can_post) { const t = await csid.postThesis({ blockchain: 'solana', mint, body: 'Accumulating here.', stance: 'bull', csid_id: claims.sub }); } ``` #### Who builds this - **Token pages in terminals and DEXs** — a discussion of verified holders next to the chart - **Charts** — thesis markers from the live theses stream - **Launchpads and communities** — proof of skin in the game instead of anonymous shilling - **Any app with token pages** — drop in the widget without building a UI #### Frequently asked questions 01 ##### Who can post a thesis? Only holders: one of the author’s verified wallets bought the token and still holds it. Anyone signed in can reply and react. 02 ##### What does a thesis show? The text, an optional bullish or bearish tag, the author’s real position and live PnL — or “Sold” once they exit — plus replies, likes and emoji reactions. 03 ##### Do I need my own UI? No. The widget is two lines of HTML and is designed in the dashboard. If you want your own UI, use the Data API, the live theses stream and the thesis.created webhook. 04 ##### Which theses does my platform show? By default theses from all platforms, so a token has content from day one. You can switch to theses written on your own instance only. 05 ##### What does it cost? Token theses are included on every CabalSpy ID plan, including Free — widget, API, live theses stream and moderation. #### Go deeper [Theses docs](https://docs.cabalspy.xyz/cabalspy-id/theses)[Try it live](https://id.cabalspy.xyz/try/thesis)[CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/)[SocialFi API & SDKs](https://www.cabalspy.xyz/socialfi-api/)[CabalSpy ID overview](https://www.cabalspy.xyz/cabalspy-id/) #### Related use cases [SocialFi LayerVerified users, their wallets and every trade — one login](https://www.cabalspy.xyz/use-cases/socialfi-layer/)[KOL Chart EventsKOL buys and sells as markers on your token chart](https://www.cabalspy.xyz/use-cases/kol-chart-events/)[KOL Holders TableLive table of KOL and Smart Money holders for any token](https://www.cabalspy.xyz/use-cases/kol-holders-table/)[All use cases13 ways to build with the KOL API](https://www.cabalspy.xyz/use-cases/) #### Build Token Theses into your product. Start free today. Free CabalSpy ID plan with sandbox and test users. Token theses included on every plan. [Open the API dashboard](https://apidashboard.cabalspy.xyz/csid)[Read the docs](https://docs.cabalspy.xyz/cabalspy-id)[See pricing](https://www.cabalspy.xyz/pricing/#cabalspy-id) --- ## Alchemy API alternative — CabalSpy KOL Wallet API | Alchemy KOL wallet labels URL: 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 Alchemy ### Alchemy API Alternative — Meet CabalSpy Alchemy is the industry's leading blockchain infrastructure provider powering Robinhood, Stripe and OpenSea across 100+ chains — but it has no KOL, Smart Money or Whale wallet label layer. CabalSpy is the specialized **KOL wallet API** that fills that gap for trading terminals. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Alchemy — feature by feature Alchemy is the dominant blockchain infrastructure platform with its Cortex engine delivering sub-50ms response times and 99.90% uptime across 100+ chains. It provides enhanced APIs for token balances, NFT data and transaction history. It is not a KOL intelligence product. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Alchemy (Alchemy API) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — infrastructure layer only | 5,500+ labeled wallets, 5 chains | | Smart Money Labels | None — not in Alchemy scope | 2,900+ Smart Money wallets | | Whale Labels | None — not in Alchemy scope | 25+ Whale wallets | | Blockchain RPC / Nodes | Yes — 100+ chains, sub-50ms (Cortex) | No — data layer only | | Enhanced APIs | Yes — NFT, token, transaction history | Yes — KOL/wallet-specific endpoints | | WebSocket / Webhooks | Yes — Alchemy Notify | Yes — KOL trade events, 24ms | | Leaderboard / Win Rate | No | Yes — PnL, WR, TXN count | | Multi-chain KOL Coverage | No | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in Widget | No | Yes — KOL/SM/Whale widget | | Uptime SLA | 99.90% (Cortex engine) | 99.90% guaranteed | | Pricing | Free 30M CU/mo · $0.40/1M CU | Free tier · from $49/month | Developer Guide · Alchemy vs CabalSpy #### CabalSpy vs Alchemy: A Developer Guide to KOL Wallet APIs (2026) ##### Does Alchemy have KOL wallet labels? No. Alchemy is a blockchain infrastructure company — one of the best in the world, powering Robinhood, Stripe, Chainlink and OpenSea. Its Cortex engine provides token balances, transaction history, NFT metadata and smart contract data across 100+ chains with sub-50ms latency. It does not maintain a curated database of Twitter-linked crypto influencer wallets, Smart Money addresses or Whale trackers. ##### What is the CabalSpy KOL API? CabalSpy is a specialized KOL wallet intelligence API that runs on top of infrastructure like Alchemy. It maintains 5,500+ verified labeled wallets across Solana, BNB Chain, Base, Ethereum and Robinhood Chain, built through community submissions, Twitter/X research and on-chain PnL verification. It is the label intelligence layer that generic infrastructure providers do not and cannot provide. ##### Alchemy vs CabalSpy — complementary products Alchemy handles infrastructure: fast RPC, reliable data delivery, sub-50ms response times across 100+ chains. CabalSpy handles KOL intelligence: which wallets belong to verified crypto influencers, what their Twitter identity is, what their historical win rate is, when they enter or exit positions. Most serious trading terminals use both. ##### Who uses CabalSpy alongside Alchemy? Trading terminals built on Alchemy infrastructure that want to add a KOL or Smart Money tab. DeFi dashboards adding 'smart money is buying this' signals. AI trading bots enriching Alchemy transaction data with KOL identity labels. Copy-trading platforms building leaderboard features with verified influencer wallet data. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Alchemy builds the infrastructure. CabalSpy adds the KOLs. Free API key. No credit card. The KOL wallet intelligence layer for applications built on Alchemy — 5,500+ verified wallets, 5 chains. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Birdeye API alternative — CabalSpy KOL Wallet API | Birdeye KOL wallet labels URL: 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 Birdeye ### Birdeye API Alternative — Meet CabalSpy Birdeye has strong Solana token analytics and a Wallet PnL API — but no curated KOL, Smart Money or Whale wallet label database. CabalSpy is the specialized **KOL wallet API** with 5,500+ Twitter-verified labeled wallets and live WebSocket feeds for trading terminals. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Birdeye — feature by feature Birdeye (birdeye.so) is a leading Solana-first token analytics platform and data API (BDS) covering token prices, OHLCV, wallet PnL, holder data and smart-money-style wallet filtering across Solana, Sui and EVM chains. It does not maintain a curated database of Twitter-linked KOL identities. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Birdeye (Birdeye / BDS API (birdeye.so)) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | No curated KOL label database | 5,500+ labeled wallets, Twitter-verified | | Smart Money Labels | Smart-money wallet filtering (generic) | 2,900+ Smart Money wallets | | Whale Labels | Whale tracker in UI (not a label API) | 25+ Whale wallets tracked | | Wallet PnL API | Yes — Solana Wallet PnL API (launched 2025) | Yes — PnL per wallet, all chains | | Token Price / OHLCV | Yes — market-leading, multi-chain | No — token price not in scope | | WebSocket Streams | Yes — price/trade events | Yes — KOL trade events, 24ms | | Leaderboard API | No curated leaderboard endpoint | Yes — Win Rate, PnL, TXN count | | Chains Covered | Solana + Sui + major EVM | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in KOL Widget | No | Yes — KOL/SM/Whale widget | | Uptime SLA | Not published for BDS API | 99.90% guaranteed | | Pricing | Free tier · usage-based BDS credits | Free tier · from $49/month flat | Developer Guide · Birdeye vs CabalSpy #### CabalSpy vs Birdeye: A Developer Guide to KOL Wallet APIs (2026) ##### Does Birdeye have KOL wallet labels? No. Birdeye (birdeye.so) is a token analytics platform with excellent real-time price data, DEX charts, Wallet PnL and on-chain trade feeds. Birdeye's UI groups wallets by 'smart money' and whale behavior, but this is generic filtering — not a curated database of verified Twitter-linked KOL identities with social graph connections and verified track records. ##### What Birdeye does well — and what CabalSpy adds Birdeye has one of the best Wallet PnL APIs on Solana (launched August 2025) and strong market data. CabalSpy adds what Birdeye doesn't have: a curated layer of 5,500+ wallets mapped to verified real-world KOL identities, their Twitter profiles, social influence scores, win rates and copy-trading leaderboard rankings. Many trading terminals use both products together. ##### Birdeye vs CabalSpy — what each does Birdeye: token price, volume, OHLCV, wallet PnL, generic holder data. CabalSpy: 5,500+ named KOL wallets, Smart Money, Whale and Insider labels, Twitter identity links, social graph, 24ms WebSocket KOL feeds, copy-trading leaderboard. Different data products for different intelligence questions. ##### Who uses CabalSpy for what Birdeye can't provide? Trading terminals that want to show 'KOL holders' — not just wallet addresses sorted by PnL, but actual named influencer identities. Copy-trading platforms building community leaderboards. Telegram bots that fire when 5+ tracked KOLs buy the same token in the same hour. AI agents that need Twitter-linked KOL identity to weight a trade signal correctly. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Birdeye has the chart. CabalSpy has the KOLs. Free API key. No credit card. The KOL wallet layer Birdeye doesn't cover — 5,500+ Twitter-verified wallets, live feeds, Solana to Robinhood Chain. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Codex API alternative — CabalSpy KOL Wallet API | Codex KOL wallet labels URL: 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 Codex ### Codex API Alternative — Meet CabalSpy Codex indexes 700M wallets and 80+ chains with excellent token price and OHLCV data — but has no KOL, Smart Money or Whale wallet label layer. CabalSpy is the specialized **KOL wallet API** with 5,500+ verified labeled wallets on Solana, BNB, Base, ETH and Robinhood. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Codex — feature by feature Codex (codex.io) is a real-time token & price data API powering TradingView across 80+ chains. It excels at token price, OHLCV, holder lists and WebSocket price feeds — but it has no KOL, Smart Money or Whale wallet label layer whatsoever. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Codex (Codex API (codex.io)) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — not in Codex scope | 5,500+ labeled wallets, 5 chains | | Smart Money Labels | None — not in Codex scope | 2,900+ Smart Money wallets | | Whale Labels | None — not in Codex scope | 25+ Whale wallets | | Token Price / OHLCV | Yes — 80+ chains, market-leading | No — token price not in scope | | WebSocket Streams | Yes — price/trade events | Yes — KOL trade events, 24ms | | REST API | Yes — token/OHLCV/holders | Yes — 15+ KOL-specific endpoints | | Chains Covered | 80+ EVM + Solana | SOL · BNB · BASE · ETH · ROBINHOOD | | Leaderboard / Win Rate | No | Yes — PnL, WR, TXN count | | Drop-in Widget | No | Yes — single line of code | | Uptime SLA | Not published | 99.90% guaranteed | | Pricing | From $350/month | Free tier · from $49/month | Developer Guide · Codex vs CabalSpy #### CabalSpy vs Codex: A Developer Guide to KOL Wallet APIs (2026) ##### Does Codex have KOL wallet labels? No. Codex (codex.io) indexes 700M+ wallets and 60M+ tokens across 80+ chains and is excellent for token price, OHLCV and holder data — powering TradingView among many others. It provides no curated KOL, Smart Money, Whale or Insider wallet label layer. When developers search for a 'Codex KOL API,' there is nothing to find. ##### What is the CabalSpy KOL API? CabalSpy is a specialized KOL wallet intelligence API covering 5,500+ labeled wallets across Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Unlike generic blockchain APIs that rely on public label sources like Arkham (exchange wallets, VC funds), CabalSpy's labels are built through community submissions, active Twitter/X research linking influencer identities to on-chain addresses, and connection-network mapping of the KOL social graph — with PnL and win rate verification on every wallet. ##### Codex vs CabalSpy — what each does Codex answers: what is the price of this token, who holds it, what is the 24h volume? CabalSpy answers: which verified KOLs, Smart Money wallets and Whales are trading this token right now? They are complementary products — many trading terminals use Codex for token market data and CabalSpy for the KOL intelligence overlay. ##### Who uses CabalSpy instead of Codex for wallet data? Trading terminals adding a 'KOL holders' tab to their token pages. Copy-trading platforms building leaderboard features ranked by verified influencer win rate. AI trading agents that need to know whether a wallet belongs to a tracked KOL before weighting a signal. Telegram alpha bots that fire when multiple KOLs pile into the same token simultaneously. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) to generate a free API key — no credit card required. 10,000 free credits (1,000 requests) included. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans start at $49/month. #### The KOL wallet layer Codex doesn't have Free API key. No credit card. 5,500+ labeled KOL wallets. The Codex API alternative for trading terminals that need real influencer wallet intelligence. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## GMGN API alternative — CabalSpy KOL Wallet API | GMGN KOL data for developers URL: 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 GMGN ### GMGN API Alternative — Meet CabalSpy GMGN is a powerful multi-chain meme trading terminal with KOL and Smart Money tracking — and it has an API (Agent API + OpenAPI). But its API is trade-execution-focused and protected by Cloudflare, making stable B2B integration difficult. CabalSpy is the enterprise **KOL wallet API** with a production SLA built for trading terminal developers. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs GMGN — feature by feature GMGN (gmgn.ai) is a multi-chain meme token trading terminal supporting Solana, BSC, Base and ETH — with smart money copy trading, KOL tracking, automated trading and a developer API (Agent API via MCP/CLI and an OpenAPI for swap execution). GMGN has KOL and Smart Money data — but its API is designed for trading bots, not stable B2B integration. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | GMGN (GMGN (gmgn.ai)) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Tracking | Yes — KOL tracking in UI and API | Yes — 5,500+ labeled wallets, REST API | | Smart Money Labels | Yes — smart money data in API | Yes — 2,900+ SM wallets, Twitter-linked | | Insider / Sniper Labels | Yes — insider, sniper, rat wallet detection | Yes — Insider wallet category | | Rate Limit (Data API) | 1 req/sec — community tier only | 5–100 req/s depending on plan | | Enterprise HA API | Explicitly not offered (stated in official docs) | Yes — production-ready, 99.90% SLA | | API Stability | "May be updated or modified irregularly" | Stable, versioned, SLA-backed | | B2B REST API | Agent/MCP (AI-focused) + OpenAPI | Yes — 15+ stable REST endpoints | | WebSocket KOL Feeds | No stable WebSocket for third parties | Yes — KOL trade events, 24ms | | Redistribution Rights | No B2B redistribution license | Yes — included in paid plans | | Drop-in Widget | No | Yes — KOL/SM/Whale widget | | Multi-chain Coverage | SOL, BSC, Base, ETH, Tron | SOL · BNB · BASE · ETH · ROBINHOOD | | Pricing | No published B2B data API pricing | Free · Starter $49 · Pro $249 · Business $499 | | Target Audience | Community devs & personal trading bots | B2B: Trading terminals, Axiom, Trojan, o1.exchange | Developer Guide · GMGN vs CabalSpy #### CabalSpy vs GMGN: A Developer Guide to KOL Wallet APIs (2026) ##### What is GMGN and does it have an API? GMGN (gmgn.ai) is a multi-chain meme token trading terminal — not a consumer UI. It supports SOL, BSC, Base, ETH and Tron with sniper bots, copy trading, smart money tracking, KOL wallet monitoring and automated trading. GMGN does have a developer API: an Agent API built for AI agents (MCP/CLI architecture) and an OpenAPI for swap routing and execution. Its trading data includes KOL and Smart Money categories. However, GMGN's own official documentation states two critical limitations for B2B use: the data API is rate-limited to 1 request per second, and — quoted directly — "We do not currently offer enterprise-grade High Availability (HA) or High Throughput APIs." The API is self-described as being for community developers, not enterprise or business customers. ##### GMGN KOL data vs CabalSpy KOL data GMGN tracks KOL wallets and smart money through its platform — this is a real and valuable dataset. The key difference from CabalSpy: GMGN's KOL data is available through a trading-focused API without a stable B2B SLA, redistribution rights or guarantee of uptime for embedded third-party products. CabalSpy's KOL API is purpose-built for trading terminals that embed KOL data in their products — with a 99.90% SLA, stable REST/WebSocket endpoints, and redistribution included in paid plans. ##### GMGN vs CabalSpy — the integration difference The clearest difference is in rate limits and enterprise positioning. GMGN's data API is capped at 1 request per second with no enterprise HA tier — their own docs explicitly state this. CabalSpy's plans start at 5 req/s (Free), scale to 20 req/s (Starter $49/mo), 50 req/s (Pro $249/mo) and 100 req/s (Business $499/mo), all with a 99.90% uptime SLA and stable, versioned endpoints. GMGN is the right choice if you are building an AI trading agent or a personal trading bot. CabalSpy is the right choice if you are building a trading terminal product that serves KOL data to thousands of users reliably at scale. ##### Who uses CabalSpy instead of GMGN's API? Trading terminal developers who need a stable, SLA-backed API they can embed in their product and guarantee uptime to their users. Platforms that need redistribution rights for KOL data in their front-end. Teams who want a flat monthly pricing model rather than an undocumented API. Those building on BNB Chain, Base, ETH or Robinhood Chain where GMGN's coverage is partial. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### GMGN is a trading terminal. CabalSpy is an enterprise API. Free API key. No credit card. 99.90% SLA, stable REST endpoints, redistribution rights — the GMGN alternative for trading terminals that need reliable KOL wallet data. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Helius API alternative — CabalSpy KOL Wallet API | Helius KOL wallet labels URL: 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 Helius ### Helius API Alternative — Meet CabalSpy Helius is the premier Solana RPC and data API — fast, reliable, developer-loved. But it is an infrastructure layer with no KOL, Smart Money or Whale wallet label database. CabalSpy is the specialized **KOL wallet API** that many Solana products run on top of Helius infrastructure. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Helius — feature by feature Helius (helius.dev) is the most popular Solana RPC and enriched data API, offering fast nodes, enhanced transaction parsing, DAS (Digital Asset Standard) support, webhooks and Solana-native data. It is infrastructure — it does not maintain a curated KOL label database. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Helius (Helius API (helius.dev)) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — infrastructure, no label DB | 1,100+ Solana KOL wallets, verified | | Smart Money Labels | None — not in Helius scope | 2,900+ Smart Money wallets | | Whale Labels | None — not in Helius scope | 25+ Whale wallets | | Solana RPC / Node | Yes — market-leading, fast | No — data layer only | | Enhanced Txn Parsing | Yes — Helius DAS / parsed transactions | Yes — KOL trade enrichment on top | | Webhook / Events | Yes — excellent Solana webhooks | Yes — KOL-specific WebSocket feeds | | Leaderboard / Win Rate | No | Yes — PnL, WR, TXN count | | Multi-chain Coverage | Solana only | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in Widget | No | Yes — KOL/SM/Whale widget | | Uptime SLA | 99.9% | 99.90% guaranteed | | Pricing | Free · from $49/month | Free tier · from $49/month | Developer Guide · Helius vs CabalSpy #### CabalSpy vs Helius: A Developer Guide to KOL Wallet APIs (2026) ##### Does Helius have KOL wallet labels? No. Helius (helius.dev) is a Solana RPC and data API — the best one available for Solana developers. It provides fast transaction delivery, enhanced parsing, DAS support, webhooks and compressed NFT data. It does not maintain a curated database of KOL wallet identities, Smart Money wallets or Whale addresses linked to Twitter accounts. It is infrastructure; CabalSpy is the intelligence layer above it. ##### How CabalSpy builds on top of Helius CabalSpy uses Solana data infrastructure — including providers like Helius — to process on-chain events and match them against its database of 1,100+ verified KOL wallets on Solana. The intelligence: who these wallets belong to, what their Twitter identity is, what their win rate and PnL history is, how they're connected in the KOL social graph — is CabalSpy's proprietary work above the raw blockchain layer. ##### Helius vs CabalSpy — complementary, not competing Helius and CabalSpy are not competing products. Helius is the best way to read Solana raw data at low latency. CabalSpy is the best way to get curated KOL wallet intelligence on Solana. Many Solana trading terminals use Helius for RPC and CabalSpy for the KOL overlay — a common and sensible architectural choice. ##### Who uses CabalSpy alongside Helius? Many Solana trading terminal developers use Helius for their RPC and CabalSpy's API for the KOL overlay. When a new token is sniped, their Helius webhook fires — and they query CabalSpy to check whether any of the snipers are tracked KOLs. That enrichment powers the KOL tab in their product. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Helius gives you the blockchain. CabalSpy gives you the KOLs. Free API key. No credit card. The KOL intelligence layer built for Solana — 1,100+ Twitter-verified wallets, live feeds, complement to Helius. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## KOLSCAN API alternative — CabalSpy KOL Wallet API | Solana, BNB, Base, ETH URL: 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. CabalSpy vs KOLSCAN ### KOLSCAN API Alternative — Meet CabalSpy KOLSCAN has no developer API. CabalSpy is the enterprise **KOL wallet API** for Solana, BNB, Base, Ethereum and Robinhood — REST endpoints, WebSocket streams and a drop-in widget. 5,500+ labeled wallets. Used by Axiom, Trojan and o1.exchange. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs KOLSCAN — feature by feature KOLSCAN (kolscan.io) is a free Solana consumer tracker with no developer API. CabalSpy is the production multi-chain KOL API built for developers building trading terminals, copy-trading platforms and AI agents. This is how they compare on every dimension that matters when choosing a **KOL wallet API**. | Feature | KOLSCAN (kolscan.io) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | Developer REST API | No official APIScraper-only, breaks without notice | 15+ REST endpointsStable, documented, SLA-backed | | WebSocket Streams | Not available | Live feeds24ms median latency, sub-second | | Embeddable Widget | Not available | Drop-in iframe widgetSingle line of code, hosted by CabalSpy | | Chains Supported | Solana only | SOL · BNB · BASE · ETH · ROBINHOODUnified schema across all chains | | KOL Wallets Tracked | 500+ walletsSolana only | 5,500+ labeled wallets1,100+ SOL · 1,400+ BNB · 1,400+ Base | | Wallet Categories | KOL only | KOL · Smart Money · Whale · Insider | | Historical Data | Last 100 transactions | 1+ year full history | | Data Freshness | Scraped UI, ~60s polling interval | 24ms median via WebSocket | | Uptime SLA | No SLA | 99.90% guaranteed | | Leaderboard API | UI only, no API access | Win rate, PnL, TXN count | | Production Partners | Consumer product, no B2B partners | Axiom · Trojan · o1.exchange · 20+ | | Built For | End users, traders, retail | Developers · Terminals · AI Bots | | Pricing | Free UI only — no API tier | Free tier · from $49/month | Developer Guide · CabalSpy vs KOLSCAN #### CabalSpy vs KOLSCAN: A Full Developer Guide to KOL Wallet APIs (2026) If you're building a Solana trading terminal, a copy-trading platform, a crypto analytics dashboard or an AI trading bot, you've almost certainly come across KOLSCAN (kolscan.io). It's well-known in the Solana memecoin community as a clean leaderboard and wallet tracker for top KOL traders. But there's a critical question developers need to ask before choosing a data source: **does KOLSCAN have an API?** The short answer is no. KOLSCAN has no official developer API. It's a consumer web application — a UI you open in a browser to manually check wallet rankings and trade history. When people search for a "KOLSCAN API," they're almost always looking for programmatic access to KOL wallet data to embed in their own products. That's exactly what CabalSpy was built to provide. ##### What is KOLSCAN? KOLSCAN is a Solana-based wallet tracker that monitors on-chain activity of prominent memecoin traders and KOLs (Key Opinion Leaders). It provides real-time transaction feeds, token profit/loss data and a public leaderboard ranking traders by performance. All features are free to use. In July 2025, KOLSCAN was acquired by Pump.fun and integrated into their gamified trading ecosystem. It tracks around 500+ wallets on Solana. It's an excellent consumer product — but it's not a developer API, and it has no plans to become one. ##### What is the CabalSpy KOL API? CabalSpy is a multi-chain labeled wallet data API designed for trading terminals, copy-trading platforms, analytics dashboards and AI trading bots. It exposes REST endpoints and WebSocket feeds covering KOL, Smart Money, Whale and Insider wallets across Solana, BNB Chain, Base, Ethereum and Robinhood Chain. With 5,500+ labeled wallets and over a year of historical data, CabalSpy is the most comprehensive KOL wallet API available to developers in 2026. ##### Why developers choose CabalSpy over scraping KOLSCAN Some developers try to access KOLSCAN data by building web scrapers or using npm packages that poll kolscan.io on a timer. This approach has serious production limitations: scrapers break without warning when KOLSCAN updates their frontend, polling intervals of 60+ seconds mean data is always stale by the time your users see it, there's no SLA or uptime guarantee, and scraper-based data cannot be redistributed to end users. KOLSCAN was also acquired by Pump.fun in 2025, introducing product-direction uncertainty. CabalSpy solves all of these problems with a purpose-built API, documented endpoints, a 99.90% uptime SLA and redistribution rights included in paid plans. ##### Key differences: CabalSpy KOL API vs KOLSCAN **Chain coverage:** KOLSCAN covers Solana only. CabalSpy covers Solana, BNB Chain, Base, Ethereum and Robinhood Chain. **Wallet categories:** KOLSCAN tracks KOL wallets only. CabalSpy tracks KOL, Smart Money, Whale and Insider wallets across all chains. **Historical data:** KOLSCAN shows the last 100 transactions by default. CabalSpy has over a year of full trade history. **Real-time delivery:** KOLSCAN scrapes data on intervals. CabalSpy WebSocket streams fire within 24ms of on-chain confirmation. **Developer access:** KOLSCAN has no API. CabalSpy has REST endpoints, WebSocket feeds and a drop-in widget. **Production trust:** KOLSCAN is a consumer product. CabalSpy is the API layer powering Axiom, Trojan, o1.exchange and 20+ other terminals. ##### How to get started with the CabalSpy KOL API Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) to generate a free API key. No credit card required. The free testing tier includes 10,000 credits (1,000 requests) — enough to explore the full endpoint range before committing to a paid plan. Full documentation is at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans start at $49/month. If you're building something that needs KOL wallet intelligence — whether a trading terminal, a copy-trading leaderboard, an AI bot or a Telegram alpha alert service — CabalSpy is the API built for exactly that use case. KOLSCAN is a great tool for traders. CabalSpy is the infrastructure for the products they use. #### Ship KOL wallet data in your product — not a browser tab Free API key. No credit card. Used in production by Axiom, Trojan and o1.exchange. The KOLSCAN API alternative built for developers. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Mobula API alternative — CabalSpy KOL Wallet API | Mobula KOL wallet labels URL: 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 Mobula ### Mobula API Alternative — Meet CabalSpy Mobula is a real-time multi-chain DeFi data API with strong token pricing, wallet PnL and even swap execution — but no curated KOL, Smart Money or Whale wallet label layer. CabalSpy is the specialized **KOL wallet API** with 5,500+ Twitter-verified wallets for trading terminals. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Mobula — feature by feature Mobula is a real-time onchain data and execution platform with 50+ endpoints and the Octopus multi-chain pricing engine. It covers token prices, OHLCV, wallet balances, historical PnL and swap execution across ETH, SOL, BNB, Base and many more chains. It has generic 'wallet labels' but no curated KOL identity database. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Mobula (Mobula API) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — no curated KOL DB | 5,500+ labeled wallets, 5 chains | | Smart Money Labels | None — no curated SM DB | 2,900+ Smart Money wallets | | Whale Labels | None — no curated Whale DB | 25+ Whale wallets | | Token Price / OHLCV | Yes — Octopus engine, 5s updates | No — token price not in scope | | Wallet PnL API | Yes — historical wallet PnL | Yes — PnL per labeled wallet | | Swap Execution Layer | Yes — built-in execution API | No | | WebSocket Streams | Yes — real-time price/trade streams | Yes — KOL trade events, 24ms | | Leaderboard / Win Rate | No | Yes — PnL, WR, TXN count | | Chains Covered | ETH, SOL, BNB, Base + many more | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in KOL Widget | No | Yes — KOL/SM/Whale widget | | Pricing | Free tier · usage-based paid | Free tier · from $49/month | Developer Guide · Mobula vs CabalSpy #### CabalSpy vs Mobula: A Developer Guide to KOL Wallet APIs (2026) ##### Does Mobula have KOL wallet labels? No. Mobula (mobula.io) is an excellent real-time DeFi data API covering prices, OHLCV, wallet PnL and even swap execution. It has generic wallet data endpoints but no curated KOL identity databases with Twitter links, verified trading track records or social graph connections. Mobula is the right choice for token market data and trading execution; CabalSpy is the right choice for KOL wallet intelligence. ##### What makes CabalSpy different from Mobula wallet data? Mobula can tell you a wallet's historical PnL and token holdings. CabalSpy can tell you that this wallet belongs to a specific Twitter crypto influencer with 200k followers, an 84% win rate over 12 months, and connections to 6 other tracked KOLs who also just bought the same token. That identity and social graph layer is what generic DeFi APIs cannot provide. ##### Mobula vs CabalSpy — when to use which Use Mobula for DeFi analytics, trading bot data infrastructure and swap execution. Use CabalSpy for KOL-signal driven trading products — terminals, leaderboards, alpha bots and copy-trading platforms. Many developers use Mobula for market data and CabalSpy for the KOL intelligence overlay simultaneously. ##### Who uses CabalSpy for what Mobula can't do? Solana trading terminals that want to show 'KOLs holding this token.' Copy-trading platforms building PnL leaderboards of verified influencer wallets. Telegram bots that fire when multiple KOLs enter the same position. AI trading agents that weight signals by the identity and track record of the wallet, not just the size of the transaction. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Mobula has the market data. CabalSpy has the KOLs. Free API key. No credit card. The KOL intelligence layer Mobula doesn't cover — 5,500+ Twitter-verified wallets, live WebSocket feeds. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Moralis API alternative — CabalSpy KOL Wallet API | Moralis KOL wallet labels URL: 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 Moralis ### Moralis API Alternative — Meet CabalSpy Moralis is the leading general-purpose Web3 API for wallets, NFTs and DeFi — but its wallet labels cover exchanges and protocols (Coinbase, Binance, 1inch), not KOL or crypto influencer wallets. CabalSpy is the specialized **KOL wallet API** with 5,500+ Twitter-verified labeled wallets. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Moralis — feature by feature Moralis is a broad Web3 data API (SOC 2 certified) covering wallet balances, NFT data, DeFi positions, transactions and address labels for known exchanges and protocols. It is not a KOL intelligence product — its labels come from public protocol registries, not Twitter KOL research. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Moralis (Moralis API) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — not in Moralis scope | 5,500+ labeled wallets, 5 chains | | Smart Money Labels | None — not in Moralis scope | 2,900+ Smart Money wallets | | Whale Labels | None — not in Moralis scope | 25+ Whale wallets | | Address Label Source | Exchanges / protocols (Coinbase, Binance…) | Community + Twitter research + graph | | Wallet Balance API | Yes — multi-chain, excellent | No — data layer only | | NFT / DeFi API | Yes — NFT metadata, DeFi positions | No — KOL data only | | WebSocket / Streams | Yes — Moralis Streams (contract events) | Yes — KOL trade events, 24ms | | Leaderboard / Win Rate | No | Yes — PnL, WR, TXN count | | Chains Covered | Solana + 30+ EVM chains | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in Widget | No KOL widget | Yes — KOL/SM/Whale widget | | Uptime SLA | 99.9% (SOC 2 Type 2 certified) | 99.90% guaranteed | | Pricing | Free · from ~$49/month | Free tier · from $49/month | Developer Guide · Moralis vs CabalSpy #### CabalSpy vs Moralis: A Developer Guide to KOL Wallet APIs (2026) ##### Does Moralis have KOL wallet labels? No. Moralis provides rich general-purpose Web3 data — wallet balances, NFT data, DeFi positions, decoded transaction history and address labels for known exchanges and protocols (Coinbase, Binance, 1inch). There is no KOL, Smart Money, Whale or Insider wallet label layer. Moralis is horizontal infrastructure; CabalSpy is vertical KOL intelligence. ##### What makes CabalSpy labels different from Moralis address labels? Moralis labels come from public protocol databases — they identify exchanges, DEXes and known contracts. CabalSpy's KOL labels come from a completely different source: community submissions of verified traders, active Twitter/X research linking influencer identities to on-chain wallets, connection-network mapping between KOLs, and PnL/win-rate verification on every wallet. This is months of human curation that no general-purpose API replicates automatically. ##### Moralis vs CabalSpy — when to use which Use Moralis to build wallet portfolio features, NFT galleries, DeFi dashboards and compliance tooling. Use CabalSpy when your product needs to surface 'which KOLs are holding this token' or 'which Smart Money wallets have the best win rate this week.' Many serious trading terminal developers use both: Moralis for general wallet data and CabalSpy for the KOL intelligence layer. ##### Who uses CabalSpy alongside Moralis? Trading terminals adding a KOL tab. Copy-trading platforms building leaderboard and PnL features. Telegram alpha bots firing multi-KOL buy signals. AI trading agents enriching decision-making with on-chain influencer data. These products use Moralis for generic wallet queries and CabalSpy specifically for KOL intelligence. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### The KOL intelligence layer Moralis doesn't have Free API key. No credit card. 5,500+ labeled wallets built from Twitter research — not exchange registries. The Moralis alternative for KOL wallet data. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Nansen alternative — CabalSpy KOL Wallet API | Solana KOL identity labels URL: 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 Nansen ### Nansen API Alternative — Meet CabalSpy Nansen has Smart Money labels on Solana and 25+ chains — but its labels are behavioral (on-chain PnL patterns), not identity-based (Twitter KOL personalities). CabalSpy is the **KOL wallet API** linking verified crypto influencer identities to on-chain wallets, built for trading terminals and copy-trading platforms. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Nansen — feature by feature Nansen (nansen.ai) is a leading on-chain analytics platform with 300M+ labeled wallets across 25+ chains including Solana. It has a REST/CLI API with Smart Money flows, Wallet Profiler and Token God Mode. Its 'Smart Money' labels track profitable on-chain behavior — not Twitter KOL identities or influencer social graphs. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Nansen (Nansen API (nansen.ai)) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | Smart Money Labels | Yes — 300M+ wallets, 25+ chains incl. Solana | Yes — 2,900+ SM wallets, Twitter-linked | | KOL / Influencer Identity | No — behavioral labels, not Twitter identities | Yes — Twitter KOL identities verified | | Whale Labels | Yes — whale classification exists | Yes — 25+ Whale wallets tracked | | Insider Wallet Labels | Partial — not explicit 'Insider' category | Yes — 100+ Insider wallets | | Solana Smart Money | Yes — extended to Solana in 2024 | Yes — 1,100+ Solana KOL wallets | | Memecoin KOL Focus | Partial — signal weaker on memecoins | Yes — built specifically for memecoins | | REST / CLI API | Yes — pay-per-use, credit-based | Yes — 15+ REST endpoints, from $49/mo | | WebSocket KOL Feeds | No real-time KOL stream | Yes — 24ms median latency | | Leaderboard / PnL API | Yes — PnL leaderboard exists | Yes — Win Rate, PnL, TXN count | | Drop-in Widget | No | Yes — KOL/SM/Whale widget | | Pricing | $49/mo annual · API: $0.01–$0.05/call | Free tier · from $49/month | Developer Guide · Nansen vs CabalSpy #### CabalSpy vs Nansen: A Developer Guide to KOL Wallet APIs (2026) ##### Does Nansen have a Solana KOL API? Nansen has Smart Money tracking on Solana (extended in 2024) and a REST/CLI API. However, its 'Smart Money' labels are behavioral — they identify wallets with historically profitable on-chain patterns (VCs, hedge funds, DeFi power users). Nansen does not maintain a label layer linking specific Twitter/X crypto influencer identities to their on-chain wallets. The signal is also documented as 'weaker on memecoins' — the exact segment where CabalSpy is specialized. ##### Nansen Smart Money vs CabalSpy KOL labels — the key difference Nansen Smart Money = 'this wallet has consistently bought before price pumps based on historical on-chain PnL.' CabalSpy KOL = 'this wallet belongs to @CryptoKOL with 180k Twitter followers, 87% win rate over 14 months, and is part of a known KOL cluster that includes 12 other tracked wallets.' The second type of label is what trading terminals need when they want to show users that specific influencers are in a token. ##### Nansen vs CabalSpy — use cases Nansen is excellent for institutional EVM analytics, DeFi smart money flows, VC tracking and general on-chain due diligence. Its API is pay-per-use at $0.01–$0.05 per call. CabalSpy is specialized for Solana/BNB/Base memecoin trading terminals, copy-trading leaderboards and KOL-signal alert bots — at a flat $49/month with a free tier. Different products for different buyer profiles. ##### Who uses CabalSpy alongside or instead of Nansen? Solana trading terminal developers who need Twitter-linked KOL identities, not just behavioral labels. Copy-trading products needing a curated leaderboard of influencer wallets with social proof. Telegram alpha bots that need to fire when 10+ KOLs enter the same token — Nansen's signal is 'weaker on memecoins,' CabalSpy is built exclusively for this. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Nansen tracks on-chain behavior. CabalSpy tracks KOL identities. Free API key. No credit card. 1,100+ Solana KOL wallets linked to Twitter identities — the Nansen alternative for influencer-intelligence-driven trading terminals. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/) --- ## Solana Tracker API alternative — CabalSpy KOL Wallet API | Solana KOL labels URL: 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 Solana Tracker ### Solana Tracker API Alternative — Meet CabalSpy Solana Tracker is a Solana analytics platform with a developer REST API for token prices, DEX data and wallet activity — but no curated KOL, Smart Money or Whale label database. CabalSpy is the specialized **KOL wallet API** with 1,100+ Solana KOL wallets, live WebSocket feeds and a drop-in widget. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read the docs](https://docs.cabalspy.xyz/) 5,500+ Labeled Wallets 1.5M+ Wallet TXN / month 10M+ API Requests / month 20+ Integration Partners 99.90% Uptime SLA Trusted by #### CabalSpy vs Solana Tracker — feature by feature Solana Tracker is a Solana-native token analytics API offering REST endpoints for token prices, holder data, DEX trades and wallet activity on Solana. It does not maintain a curated KOL wallet label database with Twitter identities or PnL-verified leaderboards. CabalSpy is the production multi-chain **KOL wallet API** built for developers who need verified influencer wallet intelligence. Here is how they compare on every dimension that matters. | Feature | Solana Tracker (Solana Tracker API) | CabalSpy KOL API (cabalspy.xyz) | | --- | --- | --- | | KOL Wallet Labels | None — no curated KOL DB | 1,100+ Solana KOL wallets, verified | | Smart Money Labels | None — not in scope | 2,900+ Smart Money wallets | | Whale Labels | None — not in scope | 25+ Whale wallets | | Solana Token / DEX Data | Yes — strong Solana focus | No — token price not in scope | | Wallet PnL API | Yes — Solana wallet PnL endpoints | Yes — PnL per labeled wallet | | WebSocket Streams | Limited | Yes — KOL trade events, 24ms | | Leaderboard / Win Rate | No curated leaderboard | Yes — PnL, WR, TXN count | | Multi-chain Coverage | Solana only | SOL · BNB · BASE · ETH · ROBINHOOD | | Drop-in Widget | No KOL widget | Yes — KOL/SM/Whale widget | | Uptime SLA | Not published | 99.90% guaranteed | | Pricing | Free · from ~$29/month | Free tier · from $49/month | Developer Guide · Solana Tracker vs CabalSpy #### CabalSpy vs Solana Tracker: A Developer Guide to KOL Wallet APIs (2026) ##### Does Solana Tracker have KOL wallet data? No. Solana Tracker provides excellent Solana token analytics — prices, DEX trades, volume, holder data, wallet PnL and on-chain activity. It is a strong general Solana data tool used by traders and developers. It does not maintain a curated KOL wallet database with Twitter-linked identities, verified win rates or copy-trading leaderboards. ##### Solana Tracker vs CabalSpy — breadth vs depth Solana Tracker is broad — it covers all tokens and all wallets on Solana. CabalSpy is narrow and deep — it covers 1,100+ specific Solana wallets verified as belonging to real crypto KOLs with Twitter presence and proven track records. Breadth vs. depth: Solana Tracker for market data, CabalSpy for KOL intelligence. ##### Key differences Both are Solana-focused products. Solana Tracker provides market-wide analytics on all Solana activity. CabalSpy provides curated intelligence on verified KOL wallets — with social identities, win rates, PnL curves and Twitter connection graphs. CabalSpy also adds BNB, Base, ETH and Robinhood coverage Solana Tracker doesn't have. ##### Who uses CabalSpy instead of Solana Tracker? Developers building trading terminals that need a 'KOL holders' tab. Copy-trading platforms that need a curated leaderboard of Solana influencer wallets. Alpha bots that fire when multiple tracked KOLs buy the same token simultaneously. Products that need to go beyond raw Solana activity data to actual KOL identity intelligence. ##### How to get started Visit [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz/) — free API key, no credit card. Full docs at [docs.cabalspy.xyz](https://docs.cabalspy.xyz/). Plans from $49/month. #### Solana Tracker has the chain. CabalSpy has the KOLs. Free API key. No credit card. 1,100+ Twitter-verified Solana KOL wallets with PnL, win rate and live WebSocket feeds. [Get free API key](https://apidashboard.cabalspy.xyz/)[Read docs](https://docs.cabalspy.xyz/)[See pricing](https://www.cabalspy.xyz/pricing/)