Token Statistics

Aggregated smart-money statistics and analytics for a single token on Solana, BNB Chain, Base and Ethereum — holder counts, total holdings with all-time peaks, buy/sell volume, net flow and realized PnL, plus a per-trader breakdown.

Token Smart Money Stats — Volume, Net Flow & Realized PnL

get

Get aggregated smart-money statistics for one token on Solana, BNB Chain, Base or Ethereum: how tracked KOL, smart money and whale wallets traded it, with buy/sell volume, net flow, buying pressure and realized PnL in native currency and USD, plus a per-trader breakdown in traders[]. Use it for token due diligence, smart-money dashboards and trading signals. This endpoint does NOT return individual transactions — use GET /v1/tokens/transactions for those.

What you get

• token — token metadata.

• total_holders — wallet counts per type plus the number of wallets still holding.

• total_holdings — summed current balance and all-time peak across all traders, each also as a percentage of supply.

• total_statistics — buy/sell, volume, net flow (native + USD), buying pressure, first and latest entry.

• traders[] — per wallet the profile, trader_holdings and trader_stats, sorted by buy volume descending.

Data source — full history from the database (no 30-day cap) merged with the newest live transactions, deduplicated by signature. Peaks are computed by chronological replay and survive a full sell-off (token_amount: 0, token_amount_peak > 0). Historical USD values come straight from the transactions.

Parameters / settings

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

• mint (required) — token mint / contract address

• type (optional) — kol, smart, or whale; if omitted, all valid wallet types for the chain are merged (counts stay split per type)

• api_key (optional if the Bearer header is used)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: bnbPossible values:

mintstringRequiredExample: 0x23a49ea152d14fe4bc41b71345b7da6687de4444

typestring · enumOptionalExample: kolPossible values:

api_keystringOptionalExample: YOUR_KEY

Responses

200

Token found — returns aggregated statistics and the trader breakdown.

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter (e.g. mint or blockchain).

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

429

Rate limit exceeded.

application/json

get

/v1/tokens/stats

HTTPcURLJavaScriptPython

GET /v1/tokens/stats?blockchain=solana&mint=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "token": {
      "mint": "0x23a49ea152d14fe4bc41b71345b7da6687de4444",
      "token_name": "Groot",
      "blockchain": "bnb",
      "currency": "BNB",
      "token_supply": 1000000000,
      "token_decimals": 18
    },
    "total_holders": {
      "kol_count": 2,
      "smart_count": 0,
      "whale_count": 0,
      "still_holding_count": 1
    },
    "total_holdings": {
      "token_amount": 14420369.662631,
      "token_amount_peak": 31497996.756192,
      "supply_pct": 1.442037,
      "supply_pct_peak": 3.1498
    },
    "total_statistics": {
      "total_buy": 0.123057,
      "total_buy_usd": 81.31,
      "total_sell": 0.114398,
      "total_sell_usd": 75.68,
      "net_flow": 0.008659,
      "net_flow_usd": 5.63,
      "total_volume": 0.237455,
      "total_volume_usd": 156.99,
      "avg_position_size": 0.061528,
      "largest_position": 0.100365,
      "buying_pressure": 0.5183,
      "first_entry_time": "2026-06-02T19:09:18.023Z",
      "first_entry_type": "kol",
      "first_entry_wallet_address": "0x39dca9c3c5daca0b453fd27c027a0cd0347ff7cb",
      "latest_entry_time": "2026-06-02T19:11:06.473Z",
      "latest_entry_type": "kol",
      "latest_entry_wallet_address": "0x39dca9c3c5daca0b453fd27c027a0cd0347ff7cb",
      "time_since_first_entry_hours": 0.1
    },
    "traders": [
      {
        "profile": {
          "wallet_address": "0x39dca9c3c5daca0b453fd27c027a0cd0347ff7cb",
          "name": "IconXBT",
          "image_url": "https://cabalspy.xyz/images/n-Twwg0T_400x400.jpg",
          "twitter": "https://x.com/iconXBT",
          "telegram": "",
          "copytrade_link": "https://t.me/maestro?start=r-tokiogaijin",
          "type": "kol",
          "blockchain": "bnb",
          "currency": "BNB"
        },
        "trader_holdings": {
          "token_amount": 0,
          "token_amount_peak": 17077627.093561,
          "supply_pct": 0,
          "supply_pct_peak": 1.707763,
          "bag_pct": 0,
          "still_holding": false
        },
        "trader_stats": {
          "buy": 0.123057,
          "buy_usd": 81.31,
          "sell": 0.114398,
          "sell_usd": 75.68,
          "volume_buy": 0.123057,
          "volume_buy_usd": 81.31,
          "volume_sell": 0.114398,
          "volume_sell_usd": 75.68,
          "realized_pnl": -0.008659,
          "realized_pnl_usd": -5.63,
          "realized_pnl_percentage": -7.04,
          "buy_count": 3,
          "sell_count": 1,
          "avg_buy_price": 7.207e-9,
          "first_trade_at": "2026-06-02T19:09:18.023Z",
          "last_trade_at": "2026-06-02T19:11:06.473Z"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_77c0aa1b9e34",
    "cached": true,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-06-02T19:12:43Z"
  }
}