Wallet Tracker

xyz.cabalspy/wallet-tracker

Tracks wallet activity from key opinion leaders, smart money traders, and whales across Solana, BNB Chain, Base, and Ethereum. You get access to wallet monitoring and leaderboard data through a streamable HTTP endpoint, letting Claude pull real-time or historical data on high-value wallet movements. Reach for this when you're analyzing on-chain behavior, following successful traders, or building alerts around whale activity. The API consolidates cross-chain wallet intelligence into a single interface, so you're not juggling separate data sources for each network. Useful for trading research, portfolio tracking, or any workflow where you need to know what large holders are doing before the market catches on.

tools: 38
transport: HTTP
last updated: Nov 1, 2026

Open website

Install

From registry metadata

$ npx add-mcp https://mcp.cabalspy.xyz/mcp --name wallet-tracker

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http wallet-tracker https://mcp.cabalspy.xyz/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 38 tools

Verified live against the running server on Nov 6, 2026.

get_startedHow to use CabalSpy: the keyless demo, where to get a free API key (1000 requests, no cost), pricing, documentation, and what the data covers. Call this first if you do not have a key yet, or if another tool returned an auth error or 'demo_limit_reached'.

How to use CabalSpy: the keyless demo, where to get a free API key (1000 requests, no cost), pricing, documentation, and what the data covers. Call this first if you do not have a key yet, or if another tool returned an auth error or 'demo_limit_reached'.

No parameters. Call it with no arguments.

get_api_statusService health and current coverage: chains, wallet types, periods, limits and how many wallets are tracked per chain. Useful when a query returns nothing and it is unclear whether the data exists at all.

Service health and current coverage: chains, wallet types, periods, limits and how many wallets are tracked per chain. Useful when a query returns nothing and it is unclear whether the data exists at all.

No parameters. Call it with no arguments.

lookup_walletIdentify a wallet address: is it tracked, and by what name. Returns the label CabalSpy attached to it — name, Twitter, Telegram, wallet type and chain. Start here when a user pastes an address and asks who it is. On EVM chains the same address can be tracked on several of them...1 params

Identify a wallet address: is it tracked, and by what name. Returns the label CabalSpy attached to it — name, Twitter, Telegram, wallet type and chain. Start here when a user pastes an address and asks who it is. On EVM chains the same address can be tracked on several of them...

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

get_wallet_trackerPeriod statistics for ONE wallet: realized PnL, win rate, volume, trade counts, active tokens and win-rate distribution. The main tool for "how is this trader doing". blockchain: solana, bnb, base, eth or rh address: the wallet address period: 6h, 1d, 7d or 30d (default 1d). L...3 params

Period statistics for ONE wallet: realized PnL, win rate, volume, trade counts, active tokens and win-rate distribution. The main tool for "how is this trader doing". blockchain: solana, bnb, base, eth or rh address: the wallet address period: 6h, 1d, 7d or 30d (default 1d). L...

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 1d

get_leaderboardTop tracked wallets ranked by performance for a chain, wallet type and period. Use for "best Solana KOLs today", "top whales this week", and similar. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale. whale is Solana only. period: 6h, 1d, 7d or 30d (def...4 params

Top tracked wallets ranked by performance for a chain, wallet type and period. Use for "best Solana KOLs today", "top whales this week", and similar. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale. whale is Solana only. period: 6h, 1d, 7d or 30d (def...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 20

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 1d

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

list_walletsBrowse the wallets CabalSpy tracks for a chain and wallet type. Use this to answer which KOLs or smart money wallets are covered at all. Always pass a limit; the full list runs into the thousands. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale limit:...4 params

Browse the wallets CabalSpy tracks for a chain and wallet type. Use this to answer which KOLs or smart money wallets are covered at all. Always pass a limit; the full list runs into the thousands. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale limit:...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 50

wallet_type*string

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.

get_wallet_historyLifetime trading history of a wallet: aggregate stats, a per-token overview and the individual trades. Use for what a wallet traded historically, rather than how it is doing now. This endpoint returns its pagination inside the payload rather than alongside it; follow paginatio...4 params

Lifetime trading history of a wallet: aggregate stats, a per-token overview and the individual trades. Use for what a wallet traded historically, rather than how it is doing now. This endpoint returns its pagination inside the payload rather than alongside it; follow paginatio...

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 50

get_wallet_holdingsCurrent onchain token holdings of a wallet, read live rather than derived from tracked trades. Slower than the other wallet tools, often over a second. If 'loading' is true the data is still warming up — call again shortly. blockchain: solana, bnb, base, eth or rh address: the...2 params

Current onchain token holdings of a wallet, read live rather than derived from tracked trades. Slower than the other wallet tools, often over a second. If 'loading' is true the data is still warming up — call again shortly. blockchain: solana, bnb, base, eth or rh address: the...

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

get_pnl_calendarDaily and monthly realized profit and loss for a wallet across its tracked history. Use for when a wallet made or lost money, and for spotting streaks. blockchain: solana, bnb, base, eth or rh address: the wallet address2 params

Daily and monthly realized profit and loss for a wallet across its tracked history. Use for when a wallet made or lost money, and for spotting streaks. blockchain: solana, bnb, base, eth or rh address: the wallet address

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

get_wallet_connectionsOther tracked wallets that traded the same tokens as this one over the last 30 days, ranked by overlap. Useful for finding groups that move together, which can indicate coordination. blockchain: solana, bnb, base, eth or rh address: the source wallet address limit: how many co...3 params

Other tracked wallets that traded the same tokens as this one over the last 30 days, ranked by overlap. Useful for finding groups that move together, which can indicate coordination. blockchain: solana, bnb, base, eth or rh address: the source wallet address limit: how many co...

Parameters* required

address*string

Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 25

compare_walletsStatistics for up to 100 wallets in a single request. Much cheaper than calling get_wallet_tracker repeatedly. Use when the user names several wallets, or to follow up on a leaderboard. blockchain: solana, bnb, base, eth or rh addresses: up to 100 wallet addresses wallet_type:...4 params

Statistics for up to 100 wallets in a single request. Much cheaper than calling get_wallet_tracker repeatedly. Use when the user names several wallets, or to follow up on a leaderboard. blockchain: solana, bnb, base, eth or rh addresses: up to 100 wallet addresses wallet_type:...

Parameters* required

addresses*array

Up to 100 wallet addresses. Far cheaper than calling get_wallet_tracker once per wallet.

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 7d

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

get_token_statsWho is trading a token: how many KOLs, smart money wallets and whales hold it, total bought and sold, buying pressure, first and latest entry, and the individual traders with their positions. The main tool for "is anyone notable in this token". Note that market cap in USD come...3 params

Who is trading a token: how many KOLs, smart money wallets and whales hold it, total bought and sold, buying pressure, first and latest entry, and the individual traders with their positions. The main tool for "is anyone notable in this token". Note that market cap in USD come...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

mint*string

Token address: the mint on Solana, the contract address on the EVM chains.

wallet_typestring

Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.default:

get_token_holdersThe tracked wallets holding a token, sorted by balance, with market cap and price in USD on Solana. Use when the user asks who is still holding, rather than who ever traded it. blockchain: solana, bnb, base, eth or rh mint: token address wallet_type: restrict to kol, smart or...4 params

The tracked wallets holding a token, sorted by balance, with market cap and price in USD on Solana. Use when the user asks who is still holding, rather than who ever traded it. blockchain: solana, bnb, base, eth or rh mint: token address wallet_type: restrict to kol, smart or...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 25

mint*string

Token address: the mint on Solana, the contract address on the EVM chains.

wallet_typestring

Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.default:

get_token_transactionsIndividual buys and sells by tracked wallets in one token, most recent first. Use for the sequence of events, for example whether KOLs bought before or after a price move. blockchain: solana, bnb, base, eth or rh mint: token address wallet_type: restrict to kol, smart or whale...4 params

Individual buys and sells by tracked wallets in one token, most recent first. Use for the sequence of events, for example whether KOLs bought before or after a price move. blockchain: solana, bnb, base, eth or rh mint: token address wallet_type: restrict to kol, smart or whale...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 25

mint*string

Token address: the mint on Solana, the contract address on the EVM chains.

wallet_typestring

Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.default:

compare_tokensStatistics for up to 100 tokens in a single request. Use for shortlists, or to follow up on the most-traded analytics view. blockchain: solana, bnb, base, eth or rh mints: up to 100 token addresses wallet_type: kol, smart or whale (default kol)3 params

Statistics for up to 100 tokens in a single request. Use for shortlists, or to follow up on the most-traded analytics view. blockchain: solana, bnb, base, eth or rh mints: up to 100 token addresses wallet_type: kol, smart or whale (default kol)

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

mints*array

Up to 100 token addresses. Use for shortlists, or to follow up on the most_traded analytics view.

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

detect_bundlesCheck whether KOL wallets bought a Solana token through Jito bundles together with side wallets they control, which hides the real size of their position. Returns each detected bundle with a confidence score and the evidence behind it: matching transaction fees, block index, a...1 params

Check whether KOL wallets bought a Solana token through Jito bundles together with side wallets they control, which hides the real size of their position. Returns each detected bundle with a confidence score and the evidence behind it: matching transaction fees, block index, a...

Parameters* required

mint*string

The Solana token mint address to inspect for bundled buys.

get_recent_tradesThe live feed: what tracked wallets are buying and selling right now, across every token or filtered to one. Use for "what are KOLs buying at the moment". blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale (default kol) minutes: only trades from the last...5 params

The live feed: what tracked wallets are buying and selling right now, across every token or filtered to one. Use for "what are KOLs buying at the moment". blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale (default kol) minutes: only trades from the last...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 25

mintstring

Restrict the result to a single token. Leave empty for all tokens.default:

minutesinteger

Only trades from the last N minutes, at most 60. Leave at 0 for the most recent trades regardless of age.default: 0

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

get_activity_metricsHow many trades happened and how much value moved over a window of up to 24 hours, plus how many distinct wallets were involved. Use for how busy the market or a single token is, rather than for the individual trades. blockchain: solana, bnb, base, eth or rh wallet_type: kol,...4 params

How many trades happened and how much value moved over a window of up to 24 hours, plus how many distinct wallets were involved. Use for how busy the market or a single token is, rather than for the individual trades. blockchain: solana, bnb, base, eth or rh wallet_type: kol,...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

hoursinteger

Observation window in hours. The server caps this at 24.default: 1

mintstring

Restrict the result to a single token. Leave empty for all tokens.default:

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

get_signalsTokens where several tracked wallets acted within the same window. 'cluster' means multiple wallets bought the same token, which is the strongest signal. 'entry' marks fresh positions, 'exit' marks wallets selling out. Use this for "what should I be looking at right now". Only...7 params

Tokens where several tracked wallets acted within the same window. 'cluster' means multiple wallets bought the same token, which is the strongest signal. 'entry' marks fresh positions, 'exit' marks wallets selling out. Use this for "what should I be looking at right now". Only...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

hoursinteger

Observation window in hours.default: 6

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 15

min_walletsinteger

Minimum wallets in a cluster. Higher means fewer but stronger signals. 0 uses the server default of 3.default: 0

min_win_ratenumber

Only count wallets above this historical win rate, 0 to 100. 0 disables it.default: 0

modestring

cluster means several wallets bought the same token, the strongest signal. entry marks fresh positions. exit marks wallets selling out.default: cluster

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

get_signal_historyPast signals, for checking whether a kind of signal has worked historically before acting on a live one. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale (default kol) days: 7, 30, 90 or "all" (default 30) mode: cluster, entry or exit. Omit for all mod...5 params

Past signals, for checking whether a kind of signal has worked historically before acting on a live one. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale (default kol) days: 7, 30, 90 or "all" (default 30) mode: cluster, entry or exit. Omit for all mod...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

daysstring

How far back to look: 7, 30, 90 or all.default: 30

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 25

modestring

Restrict to cluster, entry or exit. Leave empty for every mode.default:

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

get_callsThe curated CabalSpy calls, the same ones posted in the CabalSpy Discord, newest first. Each call has the token, the market cap at the call, the KOL and Smart Money wallets behind it, trading links, and its performance over the 24 hours after the call (peak multiple, minutes t...6 params

The curated CabalSpy calls, the same ones posted in the CabalSpy Discord, newest first. Each call has the token, the market cap at the call, the KOL and Smart Money wallets behind it, trading links, and its performance over the 24 hours after the call (peak multiple, minutes t...

Parameters* required

blockchainstring

Comma separated chains: solana, bnb, eth, rh. Empty for all chains.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 15

sincestring

Only calls at or after this time, ISO 8601 or Unix seconds. Empty for no limit.default:

tierstring

Comma separated tiers: gamble, moderate, good, big, whale. Empty for all tiers.default:

untilstring

Only calls at or before this time, ISO 8601 or Unix seconds. Empty for no limit.default:

get_call_statsHow well the curated CabalSpy calls performed: per chain and tier the number of calls, the share that reached 2x, 5x and 10x within 24 hours, the median peak multiple and minutes to peak, plus the best calls of the period. Use this for "how good are CabalSpy calls" or "which t...3 params

How well the curated CabalSpy calls performed: per chain and tier the number of calls, the share that reached 2x, 5x and 10x within 24 hours, the median peak multiple and minutes to peak, plus the best calls of the period. Use this for "how good are CabalSpy calls" or "which t...

Parameters* required

blockchainstring

Comma separated chains: solana, bnb, eth, rh. Empty for all chains.default:

periodstring

1d, 7d, 30d or 90d.default: 7d

tierstring

Comma separated tiers: gamble, moderate, good, big, whale. Empty for all tiers.default:

get_analyticsFour aggregate views over the tracked wallets. volume_trend shows activity over time. most_traded lists the tokens getting the most attention. win_rate gives the distribution of outcomes. top_performers ranks wallets by profit. Use for the overall picture rather than one walle...5 params

Four aggregate views over the tracked wallets. volume_trend shows activity over time. most_traded lists the tokens getting the most attention. win_rate gives the distribution of outcomes. top_performers ranks wallets by profit. Use for the overall picture rather than one walle...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

limitinteger

How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.default: 20

mode*string

volume_trend shows activity over time. most_traded lists the tokens getting the most attention. win_rate gives the distribution of outcomes. top_performers ranks wallets by profit.

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 7d

wallet_typestring

Wallet type. kol is a Key Opinion Leader, an influencer whose calls move markets. smart is a wallet selected for its track record. whale is a large holder, Solana only.default: kol

csid_profileCabalSpy ID profile of a crypto trader: X account (followers, age), Telegram, KOL badge, the wallets they verified by an on-chain payment (per chain), and 7-day trading activity. Use it to check who someone is and whether a trader really owns the wallets they claim, e.g. "Is @...4 params

CabalSpy ID profile of a crypto trader: X account (followers, age), Telegram, KOL badge, the wallets they verified by an on-chain payment (per chain), and 7-day trading activity. Use it to check who someone is and whether a trader really owns the wallets they claim, e.g. "Is @...

Parameters* required

addressstring

A wallet address (Solana base58 or 0x EVM). Returns the person who verified it.default:

csid_idstring

CabalSpy ID user id (a UUID, the 'sub' of a Login with CabalSpy ID token), e.g. '123e4567-e89b-12d3-a456-426614174000'.default:

usernamestring

X (Twitter) handle of the person, with or without @, e.g. 'CabalSpySol'. Pass exactly one of username, csid_id, x_id or address.default:

x_idstring

Numeric X user id, e.g. '1234567890123456789'. Survives handle changes.default:

csid_wallet_ownerWho owns a wallet? Returns the CabalSpy ID user who proved ownership with an on-chain payment (X handle, KOL badge, verified chains), or verified=false. Use it when a user pastes an address and asks who is behind it — e.g. "Who owns wallet X?" — and to find verified traders am...1 params

Who owns a wallet? Returns the CabalSpy ID user who proved ownership with an on-chain payment (X handle, KOL badge, verified chains), or verified=false. Use it when a user pastes an address and asks who is behind it — e.g. "Who owns wallet X?" — and to find verified traders am...

Parameters* required

addresses*string

One wallet address, or up to 100 separated by commas (Solana and EVM mixed), e.g. 'HHTNJXn5zDoVtbnRpYVwr7tKmnMs94cMPsu8gK2aLG9X'.

csid_kolsKOLs with a verified CabalSpy ID badge (reviewed: real X account with reach, wallets proven on-chain), newest badge first. Each entry has the X handle, followers, verified wallets and 7-day activity. Use for "Which KOLs are verified on Base?" or to get wallets of verified infl...3 params

KOLs with a verified CabalSpy ID badge (reviewed: real X account with reach, wallets proven on-chain), newest badge first. Each entry has the X handle, followers, verified wallets and 7-day activity. Use for "Which KOLs are verified on Base?" or to get wallets of verified infl...

Parameters* required

chainstring

Restrict to one blockchain: solana, bnb, base, eth or rh. Leave empty for all.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

limitinteger

How many KOLs to return (1-50, default 20).default: 20

csid_token_thesesWhat do verified holders think about a token? Returns the bull/bear summary and the latest (or top) theses: short posts that only people holding the token in a CabalSpy ID verified wallet can write, each with the author's live position (holding or sold, invested, PnL). Use for...8 params

What do verified holders think about a token? Returns the bull/bear summary and the latest (or top) theses: short posts that only people holding the token in a CabalSpy ID verified wallet can write, each with the author's live position (holding or sold, invested, PnL). Use for...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many theses to return (1-25, default 10).default: 10

mint*string

Token address: the mint on Solana, the contract address on the EVM chains.

scopestring

'global' (default): theses posted on every platform that uses CabalSpy ID. 'instance': only theses written on your own CabalSpy ID instance.default: global

sortstring

'new' (newest first, default) or 'top' (most liked first).default: new

stancestring

Only bullish ('bull') or bearish ('bear') theses. Leave empty for all, including neutral ones.default:

csid_latest_thesesThe newest theses across all tokens: a live feed of what verified holders are posting, each with token, stance, author and position. Use for "What are verified traders talking about right now?" or to discover tokens with fresh conviction. For one token use csid_token_theses. N...6 params

The newest theses across all tokens: a live feed of what verified holders are posting, each with token, stance, author and position. Use for "What are verified traders talking about right now?" or to discover tokens with fresh conviction. For one token use csid_token_theses. N...

Parameters* required

blockchainstring

Restrict to one blockchain: solana, bnb, base, eth or rh. Leave empty for all.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many theses to return (1-25, default 10).default: 10

scopestring

'global' (default): theses posted on every platform that uses CabalSpy ID. 'instance': only theses written on your own CabalSpy ID instance.default: global

usersstring

'all' (default): every author. 'instance': only users of your CabalSpy ID instance.default: all

csid_user_thesesAll theses one CabalSpy ID user has posted, newest first, with token and the position they hold. Use to judge a caller's track record: "What has @CabalSpySol been bullish on, and did it work out?". Needs your own CabalSpy API key with a CabalSpy ID instance (no demo).5 params

All theses one CabalSpy ID user has posted, newest first, with token and the position they hold. Use to judge a caller's track record: "What has @CabalSpySol been bullish on, and did it work out?". Needs your own CabalSpy API key with a CabalSpy ID instance (no demo).

Parameters* required

csid_idstring

CabalSpy ID user id (a UUID, the 'sub' of a Login with CabalSpy ID token), e.g. '123e4567-e89b-12d3-a456-426614174000'.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many theses to return (1-25, default 10).default: 10

usernamestring

X handle of the author, with or without @, e.g. 'CabalSpySol'. Pass username or csid_id.default:

csid_thesisOne thesis in full with its discussion: body, stance, author, the author's position, reactions and the replies (oldest first). Use after another csid_ tool when the user wants to read a thread. cursor pages through the replies. Needs your own CabalSpy API key with a CabalSpy I...4 params

One thesis in full with its discussion: body, stance, author, the author's position, reactions and the replies (oldest first). Use after another csid_ tool when the user wants to read a thread. cursor pages through the replies. Needs your own CabalSpy API key with a CabalSpy I...

Parameters* required

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

replies_limitinteger

How many replies to include (0-50, default 20).default: 20

thesis_id*string

Thesis id (UUID) from another csid_ tool, e.g. '7d4436ac-c0ef-4655-995f-10b06af94f21'.

csid_leaderboardRanking of CabalSpy ID verified traders by their tracked trades: volume, realized PnL, win rate and trade count for a period. Covers the users of YOUR CabalSpy ID instance (the people who signed in on your platform); scope='global' ranks every CabalSpy ID user and needs the En...7 params

Ranking of CabalSpy ID verified traders by their tracked trades: volume, realized PnL, win rate and trade count for a period. Covers the users of YOUR CabalSpy ID instance (the people who signed in on your platform); scope='global' ranks every CabalSpy ID user and needs the En...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many traders (1-50, default 10).default: 10

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 7d

scopestring

'instance' (default): the users of your CabalSpy ID instance. 'global': every CabalSpy ID user, Enterprise plan only.default: instance

sortstring

volume (default), pnl (native currency), pnl_usd, win_rate or trades.default: volume

csid_platform_userOne user of YOUR platform (white-label), looked up by your own user id: display name, wallets with their trust status, X/Telegram/KOL badge, trading stats per chain for the period (volume, realized PnL, win rate), the latest trades and theses. Use for "How is user 42 on my pla...3 params

One user of YOUR platform (white-label), looked up by your own user id: display name, wallets with their trust status, X/Telegram/KOL badge, trading stats per chain for the period (volume, realized PnL, win rate), the latest trades and theses. Use for "How is user 42 on my pla...

Parameters* required

external_id*string

The user's id on YOUR platform (external_id), as you passed it when the user was created or imported, e.g. 'did:privy:abc123' or '42'.

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 7d

csid_platform_leaderboardRanking of the users of YOUR platform (white-label) by their trades on one chain: realized PnL, volume, win rate and trade count for a period, each entry with your own user id (external_id). Use for "Who are the top traders on my platform this week?" when your users are import...7 params

Ranking of the users of YOUR platform (white-label) by their trades on one chain: realized PnL, volume, win rate and trade count for a period, each entry with your own user id (external_id). Use for "Who are the top traders on my platform this week?" when your users are import...

Parameters* required

blockchain*string

Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base, eth and rh have kol and smart. rh is Robinhood Chain, an Ethereum L2.

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many traders (1-50, default 10).default: 10

periodstring

Statistics window: 6h, 1d, 7d or 30d. Longer windows return far more data and get trimmed harder, so prefer the shortest window that answers the question.default: 7d

sortstring

pnl_usd (default), pnl (native currency), volume, win_rate or trades.default: pnl_usd

verified_onlyboolean

True ranks only payment-verified wallets. The instance setting leaderboard_trust can already enforce this.default: false

csid_competitionsCompetitions of YOUR platform (white-label): without competition_id the list (name, kind, chain, metric, status, start and end, participants); with it the rules, every rule change and the current standings with your own user ids (standings are recomputed every 5 minutes, final...4 params

Competitions of YOUR platform (white-label): without competition_id the list (name, kind, chain, metric, status, start and end, participants); with it the rules, every rule change and the current standings with your own user ids (standings are recomputed every 5 minutes, final...

Parameters* required

competition_idstring

A competition id from a previous call. Empty lists your competitions; set it for the rules and the standings.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many competitions or standings rows (1-50, default 10).default: 10

statusstring

When listing: scheduled, waiting, running, ended or cancelled. Empty lists all.default:

csid_calloutsCallouts on YOUR CabalSpy ID instance, newest first: users call a token and CabalSpy stamps the price and market cap and tracks it. Without filters the latest callouts of your platform; with chain + mint the callouts of one token ("Who called this token and how did it do?"); w...7 params

Callouts on YOUR CabalSpy ID instance, newest first: users call a token and CabalSpy stamps the price and market cap and tracks it. Without filters the latest callouts of your platform; with chain + mint the callouts of one token ("Who called this token and how did it do?"); w...

Parameters* required

chainstring

Only callouts on this blockchain: solana, bnb, base, eth or rh. Required together with mint. Leave empty for all chains.default:

csid_idstring

Only this user: their CabalSpy ID user id (UUID), for users who signed in with CabalSpy ID themselves. Pass external_id or csid_id, not both.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

external_idstring

Only this user: their id on YOUR platform (external_id), as passed when the user was created or imported. Pass external_id or csid_id, not both.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many callouts (1-50, default 10).default: 10

mintstring

Only callouts of this token (mint on Solana, contract on EVM); needs chain. Answers 'who called this token and how did it do'.default:

csid_callout_leaderboardThe best callers of YOUR CabalSpy ID instance for a period (6h, 1d, 7d, 30d): each user's callouts in the period, scored by their peak multiples (score_x), with average, median, best and summed peak multiple, hits and hit rate (share of callouts that reached hit_x), and their...8 params

The best callers of YOUR CabalSpy ID instance for a period (6h, 1d, 7d, 30d): each user's callouts in the period, scored by their peak multiples (score_x), with average, median, best and summed peak multiple, hits and hit rate (share of callouts that reached hit_x), and their...

Parameters* required

chainstring

Restrict to one blockchain: solana, bnb, base, eth or rh. Leave empty for all.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

hit_xnumber

The peak multiple that counts as a hit for hits and hit_rate_percent, e.g. 2 for a 2x (default 2, above 1 and at most 1000).default: 2

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many callers (1-50, default 10).default: 10

min_calloutsinteger

Only callers with at least this many callouts in the period (1-1000, default 1). Raise it to keep one lucky call from topping the average.default: 1

periodstring

Callouts made in the last 6h, 1d, 7d (default) or 30d.default: 7d

sortstring

avg_peak_x (default), best_peak_x, sum_peak_x, hit_rate, callouts or median_peak_x.default: avg_peak_x

csid_callout_statsThe callout track record of ONE user of YOUR CabalSpy ID instance, per period (callouts made in the last 6h, 1d, 7d and 30d): number of callouts, average, median, best and summed peak multiple (score_x), hits and hit rate (share that reached hit_x), the average multiple right...4 params

The callout track record of ONE user of YOUR CabalSpy ID instance, per period (callouts made in the last 6h, 1d, 7d and 30d): number of callouts, average, median, best and summed peak multiple (score_x), hits and hit rate (share that reached hit_x), the average multiple right...

Parameters* required

csid_idstring

Only this user: their CabalSpy ID user id (UUID), for users who signed in with CabalSpy ID themselves. Pass external_id or csid_id, not both.default:

external_idstring

Only this user: their id on YOUR platform (external_id), as passed when the user was created or imported. Pass external_id or csid_id, not both.default:

hit_xnumber

The peak multiple that counts as a hit for hits and hit_rate_percent, e.g. 2 for a 2x (default 2, above 1 and at most 1000).default: 2

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

csid_copy_tradingCopy trading on YOUR CabalSpy ID instance. Copy trading turns every trade of a trader in a user's Trade Feed into a ready-to-execute instruction: token, chain, side, the amount in USD (buys) or the share of the copied position to sell (sells), and a price limit. Your platform...7 params

Copy trading on YOUR CabalSpy ID instance. Copy trading turns every trade of a trader in a user's Trade Feed into a ready-to-execute instruction: token, chain, side, the amount in USD (buys) or the share of the copied position to sell (sells), and a price limit. Your platform...

Parameters* required

csid_idstring

Only this user: their CabalSpy ID user id (UUID). Pass external_id or csid_id, not both; required for view=settings.default:

cursorstring

Pagination cursor taken from the previous response. Leave empty for the first page.default:

external_idstring

Only this user: their id on YOUR platform (external_id). Pass external_id or csid_id, not both; required for view=settings.default:

instancestring

Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise.default:

limitinteger

How many instructions (1-50, default 10).default: 10

statusstring

view=instructions only: pending, executed, failed, skipped or expired. Leave empty for all.default:

viewstring

'instructions' (default): the copy instructions sent to your platform, newest first. 'settings': one user's copy settings per trader in their Trade Feed (needs external_id or csid_id).default: instructions

Details

Website: www.cabalspy.xyz/mcp
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026