Transactions Count - Count Trades in a Window

Count

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cabalspy.xyz/v1/transactions/count",
  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/transactions/count"

	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/transactions/count")

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": {
    "blockchain": "solana",
    "type": "kol",
    "mode": "count",
    "count": 128,
    "time_window_seconds": 3600
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

GET

transactions

count

Count

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cabalspy.xyz/v1/transactions/count",
  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/transactions/count"

	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/transactions/count")

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": {
    "blockchain": "solana",
    "type": "kol",
    "mode": "count",
    "count": 128,
    "time_window_seconds": 3600
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

A lightweight counter. Returns how many transactions tracked wallets made within a time window, up to 24 hours back. Optionally filter to a single token with mint. Use it for activity indicators and sparklines, for example how many KOL trades happened in the last hour, without pulling the full transaction list.

The window is built from seconds, minutes and hours, summed, up to a maximum of 24 hours. Without a window you get the full available window. This endpoint returns only the count, not the transactions, so it is fast and cheap.

Query Parameters

string

required

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

string

required

Wallet category kol, smart or whale.

integer

Seconds to look back. Combined with minutes and hours.

integer

Minutes to look back.

integer

Hours to look back. Maximum total window is 24 hours.

string

Optional token mint to count only that token transactions.

string

required

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

Usage Example

curl "https://api.cabalspy.xyz/v1/transactions/count?blockchain=solana&type=kol&hours=1&api_key=YOUR_KEY"

import requests

params = {"blockchain": "solana", "type": "kol", "hours": 1, "api_key": "YOUR_KEY"}
r = requests.get("https://api.cabalspy.xyz/v1/transactions/count", params=params)
d = r.json()["data"]
print("count", d["count"], "over", d["time_window_seconds"], "seconds")

const p = new URLSearchParams({
  blockchain: "solana", type: "kol", hours: "1", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/transactions/count?${p}`);
const { data } = await res.json();
console.log("count", data.count);

Response

boolean

True on success.

object

Show data

string

Requested chain.

string

Requested wallet type.

string

count.

integer

Number of transactions in the window.

integer

The effective window in seconds, after capping.

string

Present only when a mint filter was passed.

array

Present only if the requested window exceeded the 24 hour maximum and was capped.

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "type": "kol",
    "mode": "count",
    "count": 128,
    "time_window_seconds": 3600
  },
  "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	invalid_parameter	blockchain or type 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

Count

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors