Analytics

Volume trend, most-traded tokens, aggregate win rate and top performers for tracked smart money, KOL and whale wallets on Solana, BNB Chain, Base and Ethereum.

Analytics — Volume Trend, Most Traded, Win Rate & Top Performers

get

Returns one of four analytics views for a chain and wallet type over a period.

Parameters / settings

• blockchain (required) — solana, bnb, base, eth

• type (required) — kol, smart, or whale (per chain: solana → kol/smart/whale; bnb → kol/smart; base → kol/smart; eth → kol)

• mode (required) — volume_trend, most_traded, win_rate, or top_performers

• period (optional, default 7d) — 6h, 1d, 7d, or 30d

• limit (optional) — page size for list modes (most_traded, top_performers)

• api_key (optional if the Bearer header is used)

Note on units — volume_trend and most_traded are reported in native currency only (no historical USD is stored for these series).

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

typestring · enumRequiredExample: kolPossible values:

modestring · enumRequiredExample: top_performersPossible values:

periodstring · enumOptionalDefault: 7dExample: 7dPossible values:

limitinteger · min: 1OptionalExample: 25

api_keystringOptionalExample: YOUR_KEY

Responses

200

The requested analytics view.

application/json

successbooleanOptional

metaobjectOptional

Includes request_id, cached, cache_age_seconds, version, timestamp, and pagination for list modes.

400

Missing or invalid parameter (e.g. mode, period).

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

429

Rate limit exceeded.

application/json

get/v1/analytics

HTTPcURLJavaScriptPython

GET /v1/analytics?blockchain=solana&type=kol&mode=volume_trend HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "mode": "top_performers",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "data": [
      {
        "rank": 1,
        "profile": {
          "name": "Zef",
          "image_url": "https://cabalspy.xyz/images/xWZz6OAg_400x400.jpg",
          "twitter": "https://x.com/zefwashere",
          "telegram": "https://t.me/SefaPVP",
          "blockchain": "solana",
          "currency": "SOL",
          "type": "kol",
          "wallet_address": "EjtQrPTbcMevStBkpnjsH23NfUCMhGHusTYsHuGVQZp2"
        },
        "period_stats": {
          "period": "7d",
          "currency": "SOL",
          "total_buy": 120.5,
          "total_buy_usd": 7430,
          "total_sell": 188.2,
          "total_sell_usd": 11605,
          "total_volume": 308.7,
          "total_volume_usd": 19035,
          "realized_pnl": 67.7,
          "realized_pnl_usd": 4175,
          "realized_pnl_percentage": 56.18,
          "buy_txn": 41,
          "sell_txn": 33,
          "total_txn": 74,
          "win_count": 22,
          "closed_count": 30,
          "win_rate_percentage": 73.33,
          "avg_hold_time_minutes": 184.5,
          "active_tokens": 6,
          "tokens_traded": 38
        },
        "period_win_rate_distribution": {
          "win_count": 22,
          "closed_count": 30,
          "win_rate_percentage": 73.33,
          "above_500": 2,
          "above_100_to_500": 9,
          "above_zero_to_100": 11,
          "below_zero": 8
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_5a1b",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-06-06T20:16:00Z",
    "pagination": {
      "limit": 25,
      "total": 140,
      "returned": 25
    }
  }
}