Analytics

Analytics

curl --request GET \
  --url https://api.cabalspy.xyz/v1/analytics

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cabalspy.xyz/v1/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cabalspy.xyz/v1/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cabalspy.xyz/v1/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "mode": "most_traded",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "data": [
      {
        "rank": 1,
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "wallet_count": 12,
        "total_volume": 312.5,
        "total_buy": 180.25,
        "total_sell": 132.25,
        "net_flow": 48.0,
        "buying_pressure": 57.6,
        "currency": "SOL",
        "first_buy_at": "2026-07-01T09:58:00Z"
      }
    ]
  },
  "pagination": { "limit": 20, "total": 1, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

{
  "success": true,
  "data": {
    "mode": "win_rate",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "total_wallets": 342,
    "wallets_with_trades": 210,
    "win_count": 1240,
    "closed_count": 2010,
    "win_rate_percentage": 61.69,
    "distribution": {
      "above_500": 42,
      "above_100_to_500": 310,
      "above_zero_to_100": 888,
      "below_zero": 770
    }
  },
  "meta": {
    "request_id": "req_9aa1917e433b",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:02:10Z"
  }
}

GET

analytics

Analytics

curl --request GET \
  --url https://api.cabalspy.xyz/v1/analytics

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cabalspy.xyz/v1/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cabalspy.xyz/v1/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cabalspy.xyz/v1/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "mode": "most_traded",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "data": [
      {
        "rank": 1,
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "wallet_count": 12,
        "total_volume": 312.5,
        "total_buy": 180.25,
        "total_sell": 132.25,
        "net_flow": 48.0,
        "buying_pressure": 57.6,
        "currency": "SOL",
        "first_buy_at": "2026-07-01T09:58:00Z"
      }
    ]
  },
  "pagination": { "limit": 20, "total": 1, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

{
  "success": true,
  "data": {
    "mode": "win_rate",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "total_wallets": 342,
    "wallets_with_trades": 210,
    "win_count": 1240,
    "closed_count": 2010,
    "win_rate_percentage": 61.69,
    "distribution": {
      "above_500": 42,
      "above_100_to_500": 310,
      "above_zero_to_100": 888,
      "below_zero": 770
    }
  },
  "meta": {
    "request_id": "req_9aa1917e433b",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:02:10Z"
  }
}

Aggregate analytics over tracked wallets for a period. Four modes cover different questions, which tokens are most traded, which wallets perform best, what the win rate looks like, and how volume trends over time. Use it to build dashboards and leaderboards, for example a most traded tokens this week widget or a top performers table.

Choose the view with mode. All modes share the same wrapper (mode, blockchain, type, period, currency) and differ in the data they return. Set the window with period, one of 6h, 1d, 7d or 30d.

Query Parameters

string

required

Chain. One of solana, bnb, base, eth.

string

required

Wallet category kol, smart or whale.

string

required

Analytics view. One of most_traded, top_performers, win_rate, volume_trend.

string

default:"7d"

Aggregation window, one of 6h, 1d, 7d or 30d.

integer

Maximum number of items to return, for list modes.

string

required

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

Usage Example

curl "https://api.cabalspy.xyz/v1/analytics?blockchain=solana&type=kol&mode=most_traded&period=7d&limit=20&api_key=YOUR_KEY"

import requests

params = {
    "blockchain": "solana", "type": "kol", "mode": "most_traded",
    "period": "7d", "limit": 20, "api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/analytics", params=params)

for t in r.json()["data"]["data"]:
    print(t["rank"], t["token_name"], "wallets", t["wallet_count"], "vol", t["total_volume"])

const p = new URLSearchParams({
  blockchain: "solana", type: "kol", mode: "most_traded",
  period: "7d", limit: "20", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/analytics?${p}`);
const { data } = await res.json();
data.data.forEach(t => console.log(t.rank, t.token_name, t.total_volume));

Response

All modes return the same wrapper. The list modes (most_traded, top_performers) put their items in a data array. win_rate returns summary fields directly. The sections below describe each mode.

boolean

True on success.

object

Show data (common wrapper)

string

The requested mode.

string

Requested chain.

string

Requested wallet type.

string

Aggregation window.

string

Native currency.

array

Present for most_traded and top_performers. Items described below.

most_traded item

integer

Rank in the list.

string

Token mint.

string

Token name.

integer

Number of tracked wallets that traded the token.

number

Total volume (native).

number

Total bought (native).

number

Total sold (native).

number

Buy minus sell (native).

number

Buy share of volume.

string

Native currency.

string

When the first tracked buy happened.

top_performers item

object

Wallet profile.

object

Period statistics for the wallet (period, currency, total_buy, total_buy_usd, total_sell, total_sell_usd, total_volume, total_volume_usd, realized_pnl, realized_pnl_usd and related fields).

win_rate fields

For win_rate the wrapper carries the summary directly instead of a data array.

integer

Total wallets considered.

integer

Wallets that traded in the period.

integer

Winning closed positions.

integer

Total closed positions.

number

Win rate as a percentage.

object

Profit buckets (above_500, above_100_to_500, above_zero_to_100, below_zero).

volume_trend

For volume_trend the data array holds time bucketed volume points over the period.

{
  "success": true,
  "data": {
    "mode": "most_traded",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "data": [
      {
        "rank": 1,
        "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
        "token_name": "invisibull",
        "wallet_count": 12,
        "total_volume": 312.5,
        "total_buy": 180.25,
        "total_sell": 132.25,
        "net_flow": 48.0,
        "buying_pressure": 57.6,
        "currency": "SOL",
        "first_buy_at": "2026-07-01T09:58:00Z"
      }
    ]
  },
  "pagination": { "limit": 20, "total": 1, "has_more": false, "next_cursor": null },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

{
  "success": true,
  "data": {
    "mode": "win_rate",
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "total_wallets": 342,
    "wallets_with_trades": 210,
    "win_count": 1240,
    "closed_count": 2010,
    "win_rate_percentage": 61.69,
    "distribution": {
      "above_500": 42,
      "above_100_to_500": 310,
      "above_zero_to_100": 888,
      "below_zero": 770
    }
  },
  "meta": {
    "request_id": "req_9aa1917e433b",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:02:10Z"
  }
}

Errors

Status	Code	Meaning
400	invalid_parameter	blockchain, type, mode or period missing or invalid.
401	unauthorized	API key missing.
403	forbidden	API key invalid or credits exhausted.
429	rate_limited	Rate limit exceeded.

Introduction

Wallet data

Tokens

Bundle

Transactions

Signals

Query Parameters

Usage Example

Response

most_traded item

top_performers item

win_rate fields

volume_trend

Errors

​Query Parameters

​Usage Example

​Response

​most_traded item

​top_performers item

​win_rate fields

​volume_trend

​Errors

Query Parameters

Usage Example

Response

most_traded item

top_performers item

win_rate fields

volume_trend

Errors