API Reference

Per-wallet trading data across all chains and wallet types. One endpoint — works for KOL, Smart Money and Whale wallets on SOL, BNB and Base.

Get wallet trading data

get

Returns a complete trading profile for the given wallet address including:

• profile — name, avatar, social links, detected chain

• period_stats — total buy/sell volume and PNL for the requested period

• recent_trades — last 30 individual transactions

• token_overview — last 30 tokens traded with per-token PNL

The wallet is looked up across all chains simultaneously. If the wallet is not found in any chain, a 404 is returned.

Response is cached for 30 seconds per wallet + period combination.

⚠️ Tracked wallets only. This endpoint only works for wallets that CabalSpy actively monitors. The leaderboard endpoints are the source of tracked wallet addresses. Any wallet address that does not appear in a leaderboard will return 404. This is not a general-purpose blockchain explorer.

Usage examples

Solana KOL wallet:

GET /api/wallet/tracker?wallet=G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC&period=1d&chain=SOL&api_key=YOUR_KEY

BNB KOL wallet:

GET /api/wallet/tracker?wallet=0x7a2363a401b2340c7941dd2eeff0196a5078d2e6&period=7d&chain=BNB&api_key=YOUR_KEY

Base Smart Money wallet:

GET /api/wallet/tracker?wallet=0xa83b73f5644cde337b61da79589f10ea15548811&period=30d&chain=BASE&api_key=YOUR_KEY

Integration guide

To integrate this endpoint into your frontend, use the leaderboard endpoints to get wallet addresses, then call this endpoint when a user clicks on a wallet. See the full Next.js demo at https://github.com/CabalSpy/Wallet-Tracker-Demo.

Leaderboard endpoints (wallet address source)

Chain	Category	Endpoint
SOL	KOL	GET /api/stats/leaderboard
SOL	Smart Money	GET /api/stats/Smart_leaderboard
BNB	KOL	GET /api/stats/leaderboard_bnb
BNB	Smart Money	GET /api/stats/SmartBnb_leaderboard
Base	KOL	GET /api/stats/leaderboard_base
Base	Smart Money	GET /api/stats/SmartBase_leaderboard

All leaderboard entries contain a wallet_address field — pass that value directly as the wallet parameter to this endpoint.

Query parameters

api_keystringRequired

Your valid API key

Example: AjSk9daaZh4vte6KxJc1FZVJMfO8dwdWlKj8H9

walletstringRequired

Wallet address to look up.

• Solana: base58 encoded public key (~44 characters)
• BNB / Base: EVM address starting with 0x

Example: G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC

periodstring · enumOptional

Time period for stats and trade history. Defaults to 1d.

Default: 1dExample: 1dPossible values:

chainstring · enumOptional

Force a specific chain for this wallet lookup. Recommended when linking from a leaderboard — BNB and Base both use 0x addresses, so a wallet can exist on both chains simultaneously. If omitted, the chain is detected automatically.

Example: BNBPossible values:

Responses

200

Wallet found — returns full trading profile

application/json

400

Missing or invalid parameter

application/json

403

Invalid or exhausted API key

application/json

404

Wallet not found. This means the wallet is not tracked by CabalSpy. Only wallets that appear in the leaderboard endpoints can be queried. Arbitrary wallet addresses will always return 404.

application/json

500

Internal server error

application/json

get

/api/wallet/tracker

HTTPcURLJavaScriptPython

GET /api/wallet/tracker?api_key=text&wallet=text HTTP/1.1
Host: api.cabalspy.xyz
Accept: */*

{
  "profile": {
    "wallet_address": "G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC",
    "name": "Cented",
    "image_url": "https://cabalspy.xyz/images/cented.png",
    "twitter": "@Cented",
    "telegram": "",
    "chain": "SOL",
    "currency": "SOL",
    "wallet_types": [
      "kol"
    ]
  },
  "period_stats": {
    "period": "1d",
    "currency": "SOL",
    "buy": 148.2341,
    "sell": 254.182,
    "pnl": 105.9479,
    "pnl_percent": 71.48,
    "buy_count": 34,
    "sell_count": 28
  },
  "recent_trades": [
    {
      "signature": "5UfgJ5vVZxUxefDGqzqkVLHzHxVTyYH9Wpfa8TmjHnvk",
      "token_symbol": "PEPE",
      "mint": "PEPExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "transaction_type": "buy",
      "value": 4.25,
      "currency": "SOL",
      "wallet_type": "kol",
      "created_at": "2025-03-19T14:22:11Z"
    },
    {
      "signature": "3xKpQ8mNzRvTuYsWaEbDcFgHiJkLmNoPqRsTuVwXyZa",
      "token_symbol": "DOGE",
      "mint": "DOGExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "transaction_type": "sell",
      "value": 12.88,
      "currency": "SOL",
      "wallet_type": "kol",
      "created_at": "2025-03-19T13:55:03Z"
    }
  ],
  "token_overview": [
    {
      "mint": "PEPExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "token_symbol": "PEPE",
      "invested": 18.42,
      "sold": 31.75,
      "pnl": 13.33,
      "pnl_percent": 72.37,
      "currency": "SOL",
      "held": 0,
      "peak": 0,
      "bag_pct": 0,
      "supply_pct": 0,
      "last_active": "2025-03-19T14:22:11Z"
    }
  ]
}