History

{
  "success": true,
  "data": {
    "lifetime_stats": {
      "buy": 1840.5,
      "sell": 2010.75,
      "realized_pnl": 170.25,
      "realized_pnl_percentage": 9.25,
      "buy_txn": 412,
      "sell_txn": 388,
      "total_tx_count": 800,
      "win_count": 138,
      "total_sold": 225,
      "win_rate": 61.33,
      "active_tokens_count": 240,
      "largest_buy": 42.0,
      "best_trade_pnl": 88.6,
      "worst_trade_pnl": -19.4,
      "still_holding_count": 15
    },
    "win_rate_distribution": {
      "above_500": 6,
      "above_100_to_500": 28,
      "above_zero_to_100": 104,
      "below_zero": 87
    },
    "token_overview": [
      {
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "invested": 1.66,
        "sold": 0.0,
        "realized_pnl": -1.66,
        "realized_pnl_percentage": -100.0,
        "currency": "SOL",
        "buy_txn": 1,
        "sell_txn": 0,
        "first_seen": "2026-10-12T16:25:34Z",
        "last_seen": "2026-10-12T16:25:34Z",
        "still_holding": true
      }
    ],
    "trades": [
      {
        "tx_signature": "5xr8abc...",
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "transaction_type": "buy",
        "value": 1.66,
        "value_usd": 137.44,
        "currency": "SOL",
        "created_at": "2026-10-12T16:25:34Z"
      }
    ],
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"
    }
  },
  "pagination": {
    "limit": 50,
    "next_cursor": "MjAyNi0xMC0xMlQxNjoyNTozNCswMDowMHw1eHI4YWJj...",
    "has_more": true
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

{
  "success": true,
  "data": {
    "lifetime_stats": {
      "buy": 1840.5,
      "sell": 2010.75,
      "realized_pnl": 170.25,
      "realized_pnl_percentage": 9.25,
      "buy_txn": 412,
      "sell_txn": 388,
      "total_tx_count": 800,
      "win_count": 138,
      "total_sold": 225,
      "win_rate": 61.33,
      "active_tokens_count": 240,
      "largest_buy": 42.0,
      "best_trade_pnl": 88.6,
      "worst_trade_pnl": -19.4,
      "still_holding_count": 15
    },
    "win_rate_distribution": {
      "above_500": 6,
      "above_100_to_500": 28,
      "above_zero_to_100": 104,
      "below_zero": 87
    },
    "token_overview": [
      {
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "invested": 1.66,
        "sold": 0.0,
        "realized_pnl": -1.66,
        "realized_pnl_percentage": -100.0,
        "currency": "SOL",
        "buy_txn": 1,
        "sell_txn": 0,
        "first_seen": "2026-10-12T16:25:34Z",
        "last_seen": "2026-10-12T16:25:34Z",
        "still_holding": true
      }
    ],
    "trades": [
      {
        "tx_signature": "5xr8abc...",
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "transaction_type": "buy",
        "value": 1.66,
        "value_usd": 137.44,
        "currency": "SOL",
        "created_at": "2026-10-12T16:25:34Z"
      }
    ],
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"
    }
  },
  "pagination": {
    "limit": 50,
    "next_cursor": "MjAyNi0xMC0xMlQxNjoyNTozNCswMDowMHw1eHI4YWJj...",
    "has_more": true
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

The full lifetime record of a verified wallet of your users. Returns lifetime statistics, a win rate distribution across profit buckets, a per-token overview of everything the wallet has traded, and a paginated log of individual trades, newest first. Where the tracker focuses on a single period, history covers the whole life of the wallet. Use it for a complete profile page, trade exports or deep research on a trader.

The trade log is paginated. Read pagination.next_cursor from the response and pass it back as cursor to fetch the next page. When next_cursor is null you have reached the end. Statistics and the token overview always cover the whole history.

Query Parameters

string

required

Chain of the wallet. One of solana, bnb, base, eth, rh.

string

required

A wallet verified on this chain by one of your users.

integer

default:"500"

Trades per page in the trade log, 1 to 1000.

string

Cursor for the next page of trades, the pagination.next_cursor from the previous response. Empty means from the newest trade.

string

default:"instance"

global allows any CabalSpy ID wallet. Enterprise plan only.

string

Your Instance ID. Only needed when your account has several instances.

string

required

Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

curl "https://api-id.cabalspy.xyz/v1/wallets/history?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

H = {"Authorization": "Bearer YOUR_KEY"}
params = {
    "blockchain": "solana",
    "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "limit": 50,
}
r = requests.get("https://api-id.cabalspy.xyz/v1/wallets/history", params=params, headers=H).json()
d = r["data"]

print("lifetime pnl", d["lifetime_stats"]["realized_pnl"])
for t in d["trades"]:
    print(t["created_at"], t["transaction_type"], t["token_name"], t["value"])

nxt = r["pagination"]["next_cursor"]
if nxt:
    params["cursor"] = nxt

const p = new URLSearchParams({
  blockchain: "solana",
  address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
  limit: "50",
});
const res = await fetch(`https://api-id.cabalspy.xyz/v1/wallets/history?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data, pagination } = await res.json();
data.trades.forEach(t => console.log(t.created_at, t.transaction_type, t.token_name));

Response

boolean

True on success.

object

Show data

object

The owner’s profile, the same fields as on the tracker, plus wallet_address.

object

Show lifetime_stats

number

Total bought over the wallet lifetime (native).

number

Total sold over the wallet lifetime (native).

number

Lifetime realized PnL (native), sells minus buys.

number

Lifetime realized PnL percentage.

integer

Total buys.

integer

Total sells.

integer

Total trades.

number

Wins divided by tokens sold, as a percentage.

integer

Number of winning tokens.

integer

Number of tokens with at least one sell.

integer

Number of tokens ever traded.

number

Largest single buy (native).

number

Best realized PnL on a single token.

number

Worst realized PnL on a single token.

integer

Tokens where less than 95 percent of the buy value was sold.

object

Show win_rate_distribution

integer

Tokens sold for at least 5x the buy.

integer

Tokens sold for 2x to 5x.

integer

Tokens sold for more than 1x and less than 2x.

integer

Tokens sold at a loss.

array

Show token

string

Token mint or contract.

string

Token name.

string

Token logo URL.

number

Total invested in this token (native).

number

Total sold value of this token (native).

number

Realized PnL on this token (native).

number

Realized PnL percentage.

string

Native currency.

integer

Buys on this token.

integer

Sells on this token.

string

ISO timestamp of the first trade on this token.

string

ISO timestamp of the most recent trade on this token.

boolean

Whether less than 95 percent of the buy value was sold.

array

Show trade

string

Transaction signature or hash.

string

Token mint or contract.

string

Token symbol or name.

string

Token logo URL.

string

buy or sell.

number

Trade value (native).

number

Trade value in USD.

string

Native currency.

string

ISO timestamp of the trade.

object

Show pagination

integer

Trades per page.

string

Cursor for the next page (null means end).

boolean

Whether more pages follow.

{
  "success": true,
  "data": {
    "lifetime_stats": {
      "buy": 1840.5,
      "sell": 2010.75,
      "realized_pnl": 170.25,
      "realized_pnl_percentage": 9.25,
      "buy_txn": 412,
      "sell_txn": 388,
      "total_tx_count": 800,
      "win_count": 138,
      "total_sold": 225,
      "win_rate": 61.33,
      "active_tokens_count": 240,
      "largest_buy": 42.0,
      "best_trade_pnl": 88.6,
      "worst_trade_pnl": -19.4,
      "still_holding_count": 15
    },
    "win_rate_distribution": {
      "above_500": 6,
      "above_100_to_500": 28,
      "above_zero_to_100": 104,
      "below_zero": 87
    },
    "token_overview": [
      {
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "invested": 1.66,
        "sold": 0.0,
        "realized_pnl": -1.66,
        "realized_pnl_percentage": -100.0,
        "currency": "SOL",
        "buy_txn": 1,
        "sell_txn": 0,
        "first_seen": "2026-10-12T16:25:34Z",
        "last_seen": "2026-10-12T16:25:34Z",
        "still_holding": true
      }
    ],
    "trades": [
      {
        "tx_signature": "5xr8abc...",
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "token_logo": "https://...",
        "transaction_type": "buy",
        "value": 1.66,
        "value_usd": 137.44,
        "currency": "SOL",
        "created_at": "2026-10-12T16:25:34Z"
      }
    ],
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"
    }
  },
  "pagination": {
    "limit": 50,
    "next_cursor": "MjAyNi0xMC0xMlQxNjoyNTozNCswMDowMHw1eHI4YWJj...",
    "has_more": true
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

Errors

Status	Code	Meaning
400	missing_parameter	blockchain or address is missing.
400	invalid_parameter	blockchain, address, limit or cursor invalid.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	scope_not_allowed	scope=global needs the Enterprise plan.
404	wallet_not_found	The wallet is not verified on this chain by one of your users.
429	rate_limit_exceeded	Rate limit exceeded.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors