Stats
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/tokens/statsimport requests
url = "https://demo-api.cabalspy.xyz/v1/tokens/stats"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/tokens/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/tokens/stats",
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://demo-api.cabalspy.xyz/v1/tokens/stats"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/tokens/stats")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/tokens/stats")
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": {
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"market_cap_source": "live",
"market_cap_updated_at": 1783340510,
"native_price_usd": 82.36,
"sol_price_usd": 82.36
},
"total_holders": {
"kol_count": 1,
"smart_count": 0,
"whale_count": 0,
"still_holding_count": 1
},
"total_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397
},
"total_statistics": {
"total_buy": 1.66,
"total_buy_usd": 137.44,
"total_sell": 0.0,
"total_sell_usd": 0.0,
"net_flow": 1.66,
"net_flow_usd": 137.44,
"total_volume": 1.66,
"total_volume_usd": 137.44,
"avg_position_size": 1.66,
"largest_position": 1.66,
"buying_pressure": 100.0,
"first_entry_time": "2026-07-04T16:25:34Z",
"first_entry_type": "buy",
"first_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"latest_entry_time": "2026-07-04T16:25:34Z",
"latest_entry_type": "buy",
"latest_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"time_since_first_entry_hours": 42.6
},
"traders": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"trader_stats": {
"buy": 1.66,
"buy_usd": 137.44,
"sell": 0.0,
"sell_usd": 0.0,
"volume_buy": 1.66,
"volume_buy_usd": 137.44,
"volume_sell": 0.0,
"volume_sell_usd": 0.0,
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"buy_count": 1,
"sell_count": 0,
"buy_tokens": 22113972.03,
"sell_tokens": 0.0,
"avg_buy_price": 7.5e-8,
"first_trade_at": "2026-07-04T16:25:34Z",
"last_trade_at": "2026-07-04T16:25:34Z"
},
"trader_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397,
"bag_pct": 100.0,
"still_holding": true,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2
}
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Tokens
Stats
Aggregate trading statistics for one token across tracked wallets, with current market cap, holder totals, flow stats and a per trader breakdown.
GET
/
v1
/
tokens
/
stats
Stats
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/tokens/statsimport requests
url = "https://demo-api.cabalspy.xyz/v1/tokens/stats"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/tokens/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/tokens/stats",
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://demo-api.cabalspy.xyz/v1/tokens/stats"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/tokens/stats")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/tokens/stats")
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": {
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"market_cap_source": "live",
"market_cap_updated_at": 1783340510,
"native_price_usd": 82.36,
"sol_price_usd": 82.36
},
"total_holders": {
"kol_count": 1,
"smart_count": 0,
"whale_count": 0,
"still_holding_count": 1
},
"total_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397
},
"total_statistics": {
"total_buy": 1.66,
"total_buy_usd": 137.44,
"total_sell": 0.0,
"total_sell_usd": 0.0,
"net_flow": 1.66,
"net_flow_usd": 137.44,
"total_volume": 1.66,
"total_volume_usd": 137.44,
"avg_position_size": 1.66,
"largest_position": 1.66,
"buying_pressure": 100.0,
"first_entry_time": "2026-07-04T16:25:34Z",
"first_entry_type": "buy",
"first_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"latest_entry_time": "2026-07-04T16:25:34Z",
"latest_entry_type": "buy",
"latest_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"time_since_first_entry_hours": 42.6
},
"traders": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"trader_stats": {
"buy": 1.66,
"buy_usd": 137.44,
"sell": 0.0,
"sell_usd": 0.0,
"volume_buy": 1.66,
"volume_buy_usd": 137.44,
"volume_sell": 0.0,
"volume_sell_usd": 0.0,
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"buy_count": 1,
"sell_count": 0,
"buy_tokens": 22113972.03,
"sell_tokens": 0.0,
"avg_buy_price": 7.5e-8,
"first_trade_at": "2026-07-04T16:25:34Z",
"last_trade_at": "2026-07-04T16:25:34Z"
},
"trader_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397,
"bag_pct": 100.0,
"still_holding": true,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2
}
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Everything CabalSpy knows about how tracked wallets trade one token. Returns the token block with its current market cap, holder totals by wallet type, aggregate flow statistics, and a per trader breakdown with each trader stats and live position.
Use it to build a token detail page that shows which KOLs and smart money are in a token, how much they hold, and whether they are buying or selling right now.
Market cap, price and the live position fields (unrealized PnL, remaining value) are only present on Solana. On other chains those fields are null. Pass a single type to narrow to one wallet category, or omit type to aggregate all categories.
Query Parameters
Optional wallet category to narrow the breakdown kol, smart or whale. Omit to aggregate across all categories available on the chain.
Your API key, required on
https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.Try it without an API key: Try it runs on the demo server
https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demoUsage Example
curl "https://api.cabalspy.xyz/v1/tokens/stats?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/tokens/stats", params=params)
d = r.json()["data"]
print("market cap", d["token"]["market_cap"], d["token"]["market_cap_currency"])
for t in d["traders"]:
h = t["trader_holdings"]
print(t["profile"]["name"], "bag", h["bag_pct"], "uPNL", h.get("unrealized_pnl_sol"))
const p = new URLSearchParams({
blockchain: "solana",
mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/tokens/stats?${p}`);
const { data } = await res.json();
console.log("market cap", data.token.market_cap);
Response
Show data
Show data
Show token
Show token
Market cap in native currency, on every chain. See
market_cap_source for where it comes from. Null when neither a live value nor a tracked trade is available.live for the current market value of a token that is actively trading, last_trade when there is no live value and the market cap is the price of the newest tracked trade times supply, or null.Unix seconds of the market cap value: the time of the live update, or of the trade for
last_trade.Show total_statistics
Show total_statistics
Show trader, sorted by buy volume highest first
Show trader, sorted by buy volume highest first
Show trader_stats
Show trader_stats
Show trader_holdings
Show trader_holdings
Market cap in SOL when the wallet first bought, frozen. Solana only, null for older positions.
{
"success": true,
"data": {
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"market_cap_source": "live",
"market_cap_updated_at": 1783340510,
"native_price_usd": 82.36,
"sol_price_usd": 82.36
},
"total_holders": {
"kol_count": 1,
"smart_count": 0,
"whale_count": 0,
"still_holding_count": 1
},
"total_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397
},
"total_statistics": {
"total_buy": 1.66,
"total_buy_usd": 137.44,
"total_sell": 0.0,
"total_sell_usd": 0.0,
"net_flow": 1.66,
"net_flow_usd": 137.44,
"total_volume": 1.66,
"total_volume_usd": 137.44,
"avg_position_size": 1.66,
"largest_position": 1.66,
"buying_pressure": 100.0,
"first_entry_time": "2026-07-04T16:25:34Z",
"first_entry_type": "buy",
"first_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"latest_entry_time": "2026-07-04T16:25:34Z",
"latest_entry_type": "buy",
"latest_entry_wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"time_since_first_entry_hours": 42.6
},
"traders": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"trader_stats": {
"buy": 1.66,
"buy_usd": 137.44,
"sell": 0.0,
"sell_usd": 0.0,
"volume_buy": 1.66,
"volume_buy_usd": 137.44,
"volume_sell": 0.0,
"volume_sell_usd": 0.0,
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"buy_count": 1,
"sell_count": 0,
"buy_tokens": 22113972.03,
"sell_tokens": 0.0,
"avg_buy_price": 7.5e-8,
"first_trade_at": "2026-07-04T16:25:34Z",
"last_trade_at": "2026-07-04T16:25:34Z"
},
"trader_holdings": {
"token_amount": 22113972.03,
"token_amount_peak": 22113972.03,
"supply_pct": 2.211397,
"supply_pct_peak": 2.211397,
"bag_pct": 100.0,
"still_holding": true,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2
}
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | mint is missing. |
| 400 | invalid_parameter | blockchain or type invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

