Wallet Tracker

Returns a tracked wallet's full trading profile for the requested period: profile (incl. typical active trading hours over 30d), period_stats (native + USD, win rate, avg hold time), win-rate distribution, tokens traded in the period, token history, a downsampled realized-PnL chart and the individual trades. Current on-chain holdings are served by the separate GET /v1/wallet/holdings endpoint.

Get wallet trading profile

get

The wallet category (kol / smart / whale) is detected automatically. Only wallets that appear in a leaderboard are tracked — unknown addresses return 404.

Parameters / settings

• blockchain (required) — one of: solana, bnb, base, eth

• address (required) — wallet address (Solana base58 or 0x… for EVM chains)

• period (optional, default 1d) — one of: 6h, 1d, 7d, 30d

• api_key (optional if Bearer header is used)

Alias: GET /v1/wallets/tracker is identical.

Authorizations

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

addressstringRequiredExample: G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC

periodstring · enumOptionalDefault: 1dExample: 1dPossible values:

api_keystringOptionalExample: YOUR_KEY

Responses

200

Wallet found — returns full trading profile.

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter.

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

404

Wallet not tracked on this chain.

application/json

429

Rate limit exceeded.

application/json

get/v1/wallet/tracking

GET /v1/wallet/tracking?blockchain=solana&address=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "wallet": "G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC",
    "profile": {
      "name": "Cented",
      "image_url": "https://cabalspy.xyz/images/cented.png",
      "twitter": "@Cented",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "kol",
      "active_hours": "10:00-16:00 UTC"
    },
    "period_stats": {
      "period": "1d",
      "total_buy": 148.2341,
      "total_buy_usd": 21344.71,
      "total_sell": 254.182,
      "total_sell_usd": 36602.21,
      "volume": 402.4161,
      "volume_usd": 57946.92,
      "realized_pnl": 105.9479,
      "realized_pnl_usd": 15257.5,
      "realized_pnl_percentage": 71.48,
      "win_rate": 64.29,
      "avg_hold_time_minutes": 37,
      "buy_txn": 34,
      "sell_txn": 28,
      "largest_buy": 18.42,
      "best_trade_pnl": 31.75,
      "worst_trade_pnl": -4.2,
      "win_count": 9,
      "loss_count": 5
    },
    "period_win_rate_distribution": {
      "win_count": 9,
      "closed_count": 14,
      "win_rate_percentage": 64.29,
      "above_500": 2,
      "above_100_to_500": 4,
      "above_zero_to_100": 3,
      "below_zero": 5
    },
    "period_active_tokens": {
      "active_tokens_count": 1,
      "avg_position_size": 4.36,
      "still_holding_count": 1
    },
    "period_history_tokens": [
      {
        "token_name": "WIF",
        "buy_value": 31,
        "buy_value_usd": 4464,
        "sell_value": 52.4,
        "sell_value_usd": 7545.6,
        "buy_tokens": 800000,
        "sell_tokens": 800000,
        "realized_pnl": 21.4,
        "realized_pnl_usd": 3081.6,
        "realized_pnl_percentage": 69.03
      }
    ],
    "period_realized_pnl_chart": [
      {
        "timestamp": "2025-03-19T08:00:00Z",
        "realized_pnl": 12.4,
        "realized_pnl_usd": 1785.6
      },
      {
        "timestamp": "2025-03-19T11:00:00Z",
        "realized_pnl": 105.9479,
        "realized_pnl_usd": 15257.5
      }
    ],
    "period_trades": [
      {
        "token_name": "PEPE",
        "transaction_type": "buy",
        "buy_token": null,
        "sell_token": null,
        "buy_value": 4.25,
        "sell_value": 0,
        "buy_value_usd": 612,
        "sell_value_usd": 0,
        "created_at": "2025-03-19T14:22:11Z",
        "tx_signature": "5UfgJ5vVZxUxefDGqzqkVLHzHxVTyYH9Wpfa8TmjHnvk"
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "cached": true,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2025-03-19T14:22:30Z"
  }
}