Wallet History

Returns a tracked wallet's complete LIFETIME trading history — every recorded transaction with no time limit. Includes aggregated lifetime stats, a per-token overview, a win-rate distribution and the full trade list via cursor pagination. Closed days are cached immutably and only the current day is read live, so responses stay fast across the full history.

Get a wallet's lifetime trading history

get

Aggregates all recorded transactions for the wallet across its entire history (not limited to a period). Only wallets that appear in a leaderboard are tracked — unknown addresses return 404.

Parameters

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

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

• api_key (optional if Bearer header is used)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

addressstringRequiredExample: G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC

cursorstringOptional

Opaque pagination cursor from pagination.next_cursor of the previous response. Omit for the first page. Keep calling with the returned cursor until next_cursor is null to export every trade.

limitinteger · min: 1 · max: 1000Optional

Trades per page (1–1000).

Default: 500Example: 500

api_keystringOptionalExample: YOUR_KEY

Responses

200

Wallet found — returns lifetime history.

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/wallets/history

HTTPcURLJavaScriptPython

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

{
  "success": true,
  "data": {
    "profile": {
      "wallet_address": "G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC",
      "name": "Cented",
      "image_url": "https://cabalspy.xyz/images/cented.png",
      "twitter": "@Cented",
      "telegram": "",
      "blockchain": "solana",
      "type": "kol",
      "currency": "SOL"
    },
    "lifetime_stats": {
      "currency": "SOL",
      "buy": 1820.43,
      "sell": 2105.88,
      "realized_pnl": 285.45,
      "realized_pnl_percentage": 15.68,
      "buy_txn": 412,
      "sell_txn": 388,
      "total_tx_count": 800,
      "win_rate": 58.4,
      "win_count": 165,
      "total_sold": 283,
      "active_tokens_count": 47,
      "largest_buy": 42.5,
      "best_trade_pnl": 88.2,
      "worst_trade_pnl": -19.4,
      "still_holding_count": 12
    },
    "win_rate_distribution": {
      "above_500": 12,
      "above_100_to_500": 38,
      "above_zero_to_100": 74,
      "below_zero": 159
    },
    "token_overview": [
      {
        "mint": "9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9A",
        "token_name": "dogwifhat",
        "invested": 31,
        "sold": 52.4,
        "realized_pnl": 21.4,
        "realized_pnl_percentage": 69.03,
        "currency": "SOL",
        "buy_txn": 4,
        "sell_txn": 3,
        "first_seen": "2025-01-08T11:02:00Z",
        "last_seen": "2025-03-18T22:14:00Z",
        "still_holding": false
      }
    ],
    "trades": [
      {
        "tx_signature": "5UfgJ5vVZxUxefDGqzqkVLHzHxVTyYH9Wpfa8TmjHnvk",
        "mint": "9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9A",
        "token_name": "dogwifhat",
        "transaction_type": "buy",
        "value": 4.25,
        "currency": "SOL",
        "created_at": "2025-03-18T14:22:11Z"
      }
    ],
    "pagination": {
      "limit": 500,
      "next_cursor": "MjAyNS0wMy0xOFQxNDoyMjoxMVp8NVVmZ0o1...",
      "has_more": true
    }
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "cached": true,
    "version": "1.0.0",
    "timestamp": "2025-03-19T14:22:30Z"
  }
}