canonical: https://jentic.com/apis/cabalspy.xyz/cabalspy # Cabalspy Xyz CabalSpy API The CabalSpy API returns on-chain intelligence on labeled wallets across Solana, BNB Chain, Base, Ethereum, and Robinhood Chain, covering tracked KOL, Smart Money, and Whale addresses. It serves wallet profiles, holdings, lifetime PnL calendars, leaderboards, token holder breakdowns and transactions, Solana bundle snapshots, live signals, and aggregate analytics over a time window. Every response shares a common envelope with request metadata and optional pagination. ## For AI agents Query on-chain wallet and token intelligence for Solana, BNB Chain, Base, Ethereum, and Robinhood Chain: look up labeled wallets, rank leaderboards, read holdings and PnL, and pull token holders, transactions, and live signals. ## Scope Does not handle trade execution, wallet custody, or token swaps. Use for on-chain wallet and token analytics only. ## Capabilities - Look up labeled KOL, Smart Money, and Whale wallets across Solana, BNB Chain, Base, Ethereum, and Robinhood Chain - Rank tracked wallets by performance on the leaderboard - Read a wallet's on-chain holdings and lifetime PnL calendar - Pull token holder breakdowns and recent token transactions - Detect Solana bundle snapshots for a token launch - Stream live signals and query aggregate analytics across a time window ## Use cases ### Agent-driven wallet due diligence Before an agent acts on a wallet, it pulls that wallet's label, on-chain holdings, and lifetime PnL from CabalSpy to judge whether it is a tracked KOL, Smart Money, or Whale address. The agent discovers the CabalSpy lookup and holdings operations through Jentic, fills in the wallet address and chain, and reads structured JSON back without browsing the reference docs. Example prompt: Look up a Solana wallet's profile and holdings, then read its PnL calendar and report whether it is labeled Smart Money ### Smart Money leaderboard monitoring Track which labeled wallets are performing best on a given chain by reading the CabalSpy leaderboard, filtered to the wallet type and chain you care about. The leaderboard ranks tracked wallets so an agent can surface the current top performers on Solana or BNB Chain for a research digest. Example prompt: Read the wallet leaderboard for Smart Money wallets on Solana and return the top ten ranked by performance ### Token holder and flow analysis Analyse who holds a token and how it is trading by combining CabalSpy token holder breakdowns with recent token transactions and transaction volume over a window. This lets an agent summarise concentration among labeled wallets and recent buy and sell flow for a token on Solana or another supported chain. Example prompt: Pull the holder breakdown for a token, then read its recent transactions and volume over the last 24 hours and summarise net flow ### Live signal alerting Watch CabalSpy live signals and signal history to catch notable on-chain wallet activity as it happens. An agent can poll the signals feed and raise an alert when tracked wallets make a move, then pull the related wallet or token detail for context. Example prompt: Fetch the latest live signals, and for each signal involving a tracked wallet, look up that wallet's recent transactions for context ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/wallets/tracker` | Wallet tracker profile | | GET | `/wallets/leaderboard` | Rank tracked wallets by performance | | GET | `/wallets/holdings` | Wallet on-chain holdings | | GET | `/wallet/pnl_calendar` | Wallet PnL calendar | | GET | `/tokens/holders` | Token holder breakdown | | GET | `/tokens/transactions` | Token transactions | | GET | `/signals` | Live signals for tracked wallets | | GET | `/analytics` | Aggregate analytics | ## Key resources - **Wallets** — Look up labeled wallets, leaderboards, trackers, holdings, PnL calendars, lifetime history, and connections - **Tokens** — Read token stats, holder breakdowns, and token transactions - **Transactions** — Retrieve latest transactions, time-window transactions, counts, and volume - **Signals** — Read live signals and signal history for tracked wallet activity - **Analytics** — Query aggregate analytics across the tracked-wallet dataset - **Bundle** — Fetch Solana bundle snapshots for a token launch ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 62 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 99 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 48 / 100 - Agent Usability: 94 / 100 - Security: 38 / 100 - AI Discoverability: 74 / 100 - **View full report:** https://jentic.com/apis/cabalspy.xyz/cabalspy/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the CabalSpy API by hand means sending your key as either the api_key query parameter or an Authorization bearer header, watching the per-plan request and credit limits, and unpacking its shared response envelope yourself. Through Jentic you install once, import the CabalSpy API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The CabalSpy API is read-only and carries the wallet address and chain in the query string, so a rule bounds which operations your agent may call, not which wallet. You choose the operations it may call, such as wallet lookups and token stats, so the rest of the surface stays off unless you add it. - **Credential handling:** Your CabalSpy key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'find top Smart Money wallets' or 'read a token's holders', and Jentic returns the matching CabalSpy operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Nansen** — Labeled on-chain wallet intelligence across multiple chains - **Dune** — Query on-chain data with SQL and read results via API - **CoinGecko** — Token prices and market data to pair with wallet activity - **Moralis** — Raw blockchain balances and transfers across chains ## FAQ ### What authentication does the CabalSpy API use? The CabalSpy API authenticates with an API key per its OpenAPI spec, sent either as the api_key query parameter or as an Authorization bearer header; the two are equivalent. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's context. ### Can I track Smart Money wallets with the CabalSpy API? Yes. The wallet leaderboard and wallet tracker operations rank and profile labeled wallets, including Smart Money, KOL, and Whale addresses, across Solana, BNB Chain, Base, Ethereum, and Robinhood Chain. Note that Whale labels are available on Solana, and chain coverage of wallet types varies by chain. ### What are the rate limits for the CabalSpy API? The OpenAPI spec describes per-second request limits that vary by plan, starting at five requests per second on the free tier, plus a monthly credit allowance that each request draws down. Check the CabalSpy documentation at https://docs.cabalspy.xyz for current limits and credit costs. ### Is there a CabalSpy MCP server? You don't need an MCP server to give your agent the CabalSpy API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the wallet, token, and signal operations it needs. ### Can I limit what my agent is allowed to do with the CabalSpy API? Yes. Because every CabalSpy operation is a read and the wallet is passed as a query parameter, you scope by operation: write a rule that allows just the lookups you need, such as wallet profiles and the leaderboard, and the agent can call those and nothing else, with each request logged. ### How do I look up a wallet through Jentic? Search Jentic for 'look up a Solana wallet', and it returns the CabalSpy wallet lookup operation with its input schema; your agent supplies the address and chain and calls it. To run it on your own infrastructure, install Jentic One from its GitHub repo.