get_started

How to use CabalSpy: 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_startedArguments"
}

get_api_status

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_api_statusArguments"
}

lookup_wallet

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 and only the first match is returned, so the reported chain may not be the intended one. address: the wallet address to look up

Parameters1

address

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "title": "lookup_walletArguments"
}

get_wallet_tracker

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). Longer periods return far more data and are trimmed harder; prefer the shortest period that answers it.

Parameters3

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
address	string	required	Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.
period	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    },
    "period": {
      "default": "1d",
      "description": "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.",
      "title": "Period",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "address"
  ],
  "title": "get_wallet_trackerArguments"
}

get_leaderboard

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, eth has kol only. period: 6h, 1d, 7d or 30d (default 1d) limit: how many wallets (default 20)

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	optional	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.
period	string	optional	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.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "period": {
      "default": "1d",
      "description": "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.",
      "title": "Period",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain"
  ],
  "title": "get_leaderboardArguments"
}

list_wallets

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: wallets per page (default 50) cursor: pagination cursor from the previous response

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	required	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.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.
cursor	string	optional	Pagination cursor taken from the previous response. Leave empty for the first page.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "cursor": {
      "default": "",
      "description": "Pagination cursor taken from the previous response. Leave empty for the first page.",
      "title": "Cursor",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "wallet_type"
  ],
  "title": "list_walletsArguments"
}

get_wallet_history

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 pagination.next_cursor until it is null for a full export. blockchain: solana, bnb, base, eth or rh address: the wallet address cursor: pagination cursor from the previous response limit: trades per page, 1-1000 (default 50; higher values get trimmed anyway)

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
address	string	required	Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.
cursor	string	optional	Pagination cursor taken from the previous response. Leave empty for the first page.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    },
    "cursor": {
      "default": "",
      "description": "Pagination cursor taken from the previous response. Leave empty for the first page.",
      "title": "Cursor",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain",
    "address"
  ],
  "title": "get_wallet_historyArguments"
}

get_wallet_holdings

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 wallet address

Parameters2

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
address	string	required	Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "address"
  ],
  "title": "get_wallet_holdingsArguments"
}

get_pnl_calendar

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

Parameters2

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
address	string	required	Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "address"
  ],
  "title": "get_pnl_calendarArguments"
}

get_wallet_connections

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 connections (default 25)

Parameters3

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
address	string	required	Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "address": {
      "description": "Wallet address. Base58 on Solana, 0x-prefixed hex on the EVM chains.",
      "title": "Address",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain",
    "address"
  ],
  "title": "get_wallet_connectionsArguments"
}

compare_wallets

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: kol, smart or whale (default kol) period: 6h, 1d, 7d or 30d (default 7d)

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
addresses	array	required	Up to 100 wallet addresses. Far cheaper than calling get_wallet_tracker once per wallet.
wallet_type	string	optional	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.
period	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "addresses": {
      "description": "Up to 100 wallet addresses. Far cheaper than calling get_wallet_tracker once per wallet.",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Addresses",
      "type": "array"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "period": {
      "default": "7d",
      "description": "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.",
      "title": "Period",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "addresses"
  ],
  "title": "compare_walletsArguments"
}

get_token_stats

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 comes back empty on this endpoint even for Solana; get_token_holders reports it. blockchain: solana, bnb, base, eth or rh mint: token mint address on Solana, contract address on the EVM chains wallet_type: restrict to kol, smart or whale. Omit to merge all types.

Parameters3

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
mint	string	required	Token address: the mint on Solana, the contract address on the EVM chains.
wallet_type	string	optional	Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "mint": {
      "description": "Token address: the mint on Solana, the contract address on the EVM chains.",
      "title": "Mint",
      "type": "string"
    },
    "wallet_type": {
      "default": "",
      "description": "Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.",
      "title": "Wallet Type",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "mint"
  ],
  "title": "get_token_statsArguments"
}

get_token_holders

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 whale. Omit to merge all types. limit: how many holders (default 25)

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
mint	string	required	Token address: the mint on Solana, the contract address on the EVM chains.
wallet_type	string	optional	Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "mint": {
      "description": "Token address: the mint on Solana, the contract address on the EVM chains.",
      "title": "Mint",
      "type": "string"
    },
    "wallet_type": {
      "default": "",
      "description": "Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.",
      "title": "Wallet Type",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain",
    "mint"
  ],
  "title": "get_token_holdersArguments"
}

get_token_transactions

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. Omit to merge all types. limit: how many transactions (default 25)

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
mint	string	required	Token address: the mint on Solana, the contract address on the EVM chains.
wallet_type	string	optional	Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "mint": {
      "description": "Token address: the mint on Solana, the contract address on the EVM chains.",
      "title": "Mint",
      "type": "string"
    },
    "wallet_type": {
      "default": "",
      "description": "Restrict to one wallet type: kol, smart or whale. Leave empty to merge all types the chain has.",
      "title": "Wallet Type",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain",
    "mint"
  ],
  "title": "get_token_transactionsArguments"
}

compare_tokens

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)

Parameters3

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
mints	array	required	Up to 100 token addresses. Use for shortlists, or to follow up on the most_traded analytics view.
wallet_type	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "mints": {
      "description": "Up to 100 token addresses. Use for shortlists, or to follow up on the most_traded analytics view.",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Mints",
      "type": "array"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    }
  },
  "required": [
    "blockchain",
    "mints"
  ],
  "title": "compare_tokensArguments"
}

detect_bundles

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, and adjacency to the KOL's own transaction. Use this when a user asks whether a launch was bundled, insider-heavy, sniped or manipulated. Solana only, because it depends on Jito bundles. mint: the Solana token mint address

Parameters1

mint

string

required

The Solana token mint address to inspect for bundled buys.

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "description": "The Solana token mint address to inspect for bundled buys.",
      "title": "Mint",
      "type": "string"
    }
  },
  "required": [
    "mint"
  ],
  "title": "detect_bundlesArguments"
}

get_recent_trades

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 N minutes, at most 60. Leave at 0 for the most recent trades regardless of age. mint: restrict to one token limit: how many trades (default 25)

Parameters5

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	optional	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.
minutes	integer	optional	Only trades from the last N minutes, at most 60. Leave at 0 for the most recent trades regardless of age.
mint	string	optional	Restrict the result to a single token. Leave empty for all tokens.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "minutes": {
      "default": 0,
      "description": "Only trades from the last N minutes, at most 60. Leave at 0 for the most recent trades regardless of age.",
      "maximum": 60,
      "minimum": 0,
      "title": "Minutes",
      "type": "integer"
    },
    "mint": {
      "default": "",
      "description": "Restrict the result to a single token. Leave empty for all tokens.",
      "title": "Mint",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain"
  ],
  "title": "get_recent_tradesArguments"
}

get_activity_metrics

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, smart or whale (default kol) hours: window in hours, at most 24 (default 1) mint: restrict to one token

Parameters4

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	optional	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.
hours	integer	optional	Observation window in hours. The server caps this at 24.
mint	string	optional	Restrict the result to a single token. Leave empty for all tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "hours": {
      "default": 1,
      "description": "Observation window in hours. The server caps this at 24.",
      "maximum": 24,
      "minimum": 1,
      "title": "Hours",
      "type": "integer"
    },
    "mint": {
      "default": "",
      "description": "Restrict the result to a single token. Leave empty for all tokens.",
      "title": "Mint",
      "type": "string"
    }
  },
  "required": [
    "blockchain"
  ],
  "title": "get_activity_metricsArguments"
}

get_signals

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 the first page is reachable: this endpoint reports that more results exist but does not return a usable cursor, so raise the limit rather than trying to paginate. Smart money signals are unavailable on eth. blockchain: solana, bnb, base, eth or rh wallet_type: kol, smart or whale (default kol) mode: cluster, entry or exit (default cluster) hours: observation window (default 6) min_wallets: minimum wallets in a cluster; higher means fewer, stronger signals min_win_rate: only count wallets above this historical win rate, 0-100 limit: how many signals (default 15)

Parameters7

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	optional	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.
mode	string	optional	cluster means several wallets bought the same token, the strongest signal. entry marks fresh positions. exit marks wallets selling out.
hours	integer	optional	Observation window in hours.
min_wallets	integer	optional	Minimum wallets in a cluster. Higher means fewer but stronger signals. 0 uses the server default of 3.
min_win_rate	number	optional	Only count wallets above this historical win rate, 0 to 100. 0 disables it.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "mode": {
      "default": "cluster",
      "description": "cluster means several wallets bought the same token, the strongest signal. entry marks fresh positions. exit marks wallets selling out.",
      "title": "Mode",
      "type": "string"
    },
    "hours": {
      "default": 6,
      "description": "Observation window in hours.",
      "maximum": 168,
      "minimum": 1,
      "title": "Hours",
      "type": "integer"
    },
    "min_wallets": {
      "default": 0,
      "description": "Minimum wallets in a cluster. Higher means fewer but stronger signals. 0 uses the server default of 3.",
      "maximum": 50,
      "minimum": 0,
      "title": "Min Wallets",
      "type": "integer"
    },
    "min_win_rate": {
      "default": 0,
      "description": "Only count wallets above this historical win rate, 0 to 100. 0 disables it.",
      "maximum": 100,
      "minimum": 0,
      "title": "Min Win Rate",
      "type": "number"
    },
    "limit": {
      "default": 15,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain"
  ],
  "title": "get_signalsArguments"
}

get_signal_history

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 modes. limit: how many signals (default 25)

Parameters5

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
wallet_type	string	optional	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.
days	string	optional	How far back to look: 7, 30, 90 or all.
mode	string	optional	Restrict to cluster, entry or exit. Leave empty for every mode.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "days": {
      "default": "30",
      "description": "How far back to look: 7, 30, 90 or all.",
      "title": "Days",
      "type": "string"
    },
    "mode": {
      "default": "",
      "description": "Restrict to cluster, entry or exit. Leave empty for every mode.",
      "title": "Mode",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain"
  ],
  "title": "get_signal_historyArguments"
}

get_analytics

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 wallet or token. blockchain: solana, bnb, base, eth or rh mode: volume_trend, most_traded, win_rate or top_performers wallet_type: kol, smart or whale (default kol) period: 6h, 1d, 7d or 30d (default 7d) limit: how many entries (default 20)

Parameters5

blockchain	string	required	Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.
mode	string	required	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.
wallet_type	string	optional	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.
period	string	optional	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.
limit	integer	optional	How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.

Raw schema

{
  "type": "object",
  "properties": {
    "blockchain": {
      "description": "Blockchain. One of: solana, bnb, base, eth, rh. solana has kol, smart and whale wallets; bnb, base and rh have kol and smart; eth has kol only. rh is Robinhood Chain, an Ethereum L2.",
      "title": "Blockchain",
      "type": "string"
    },
    "mode": {
      "description": "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.",
      "title": "Mode",
      "type": "string"
    },
    "wallet_type": {
      "default": "kol",
      "description": "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.",
      "title": "Wallet Type",
      "type": "string"
    },
    "period": {
      "default": "7d",
      "description": "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.",
      "title": "Period",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "How many entries to return. Keep it small: large results are trimmed to fit the context window anyway.",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "blockchain",
    "mode"
  ],
  "title": "get_analyticsArguments"
}

xyz.cabalspy/wallet-tracker

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_started

get_api_status

lookup_wallet

get_wallet_tracker

get_leaderboard

list_wallets

get_wallet_history

get_wallet_holdings

get_pnl_calendar

get_wallet_connections

compare_wallets

get_token_stats

get_token_holders

get_token_transactions

compare_tokens

detect_bundles

get_recent_trades

get_activity_metrics

get_signals

get_signal_history

get_analytics

Install

Remote endpoint

Related servers