Transactions
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/tokens/transactionsimport requests
url = "https://demo-api.cabalspy.xyz/v1/tokens/transactions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/tokens/transactions', 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/transactions",
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/transactions"
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/transactions")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/tokens/transactions")
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
},
"transactions": [
{
"tx_signature": "5xr8abc...",
"transaction_type": "buy",
"value": 1.66,
"value_usd": 137.44,
"currency": "SOL",
"token_amount": 22113972.03,
"price_per_token": 7.5e-8,
"price_per_token_usd": 6.2e-6,
"market_cap": 75.0,
"market_cap_usd": 6200.0,
"created_at": "2026-07-04T16:25:34Z",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"holdings_after": {
"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
}
}
]
},
"pagination": {
"limit": 50,
"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"
}
}
Tokens
Transactions
The individual buy and sell transactions of tracked wallets on one token, newest first, each with the holder position after the trade.
GET
/
v1
/
tokens
/
transactions
Transactions
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/tokens/transactionsimport requests
url = "https://demo-api.cabalspy.xyz/v1/tokens/transactions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/tokens/transactions', 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/transactions",
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/transactions"
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/transactions")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/tokens/transactions")
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
},
"transactions": [
{
"tx_signature": "5xr8abc...",
"transaction_type": "buy",
"value": 1.66,
"value_usd": 137.44,
"currency": "SOL",
"token_amount": 22113972.03,
"price_per_token": 7.5e-8,
"price_per_token_usd": 6.2e-6,
"market_cap": 75.0,
"market_cap_usd": 6200.0,
"created_at": "2026-07-04T16:25:34Z",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"holdings_after": {
"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
}
}
]
},
"pagination": {
"limit": 50,
"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"
}
}
The individual buy and sell transactions of tracked wallets on one token, newest first. Each entry carries the trader profile, the trade value and token amount, and the holder position after that trade, so you can replay how positions built up or unwound.
Use it to render a live trade tape for a token, the scrolling feed of who bought or sold and when. The token block carries the market cap, and every trade carries the market cap at the moment it happened, so you can place it on a chart.
These are individual events, not positions, so they do not carry unrealized PnL. Each transaction includes holdings_after, the holder bag right after that trade. The list is newest first and paginated with limit and cursor. Poll with since to receive only new trades: a poll that finds nothing new costs 0 credits.
Query Parameters
Opaque cursor for the next page. Pass the
next_cursor value from the previous response, together with the same limit. A null next_cursor means there are no more pages.Only return transactions at or after this time. Accepts Unix seconds, Unix milliseconds or an ISO 8601 timestamp in UTC. The bound is inclusive so no trade in the same second is lost, so deduplicate by
tx_signature. If no transaction is newer than since, the request costs 0 credits.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 demoPolling for new trades
To keep a chart or trade tape current, pass thecreated_at of the newest trade you already have as since. You get only the new trades, and a poll that finds nothing new is free. The X-Credits-Charged response header shows what a request cost.
curl "https://api.cabalspy.xyz/v1/tokens/transactions?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&since=2026-07-04T16:25:34Z&api_key=YOUR_KEY"
For a live feed, the Transactions Stream filtered to one token is cheaper still: it pushes each trade the moment it happens and bills 1 credit per delivered trade, instead of polling.
Usage Example
curl "https://api.cabalspy.xyz/v1/tokens/transactions?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"limit": 50, "api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/tokens/transactions", params=params)
d = r.json()["data"]
for tx in d["transactions"]:
print(tx["created_at"], tx["transaction_type"], tx["profile"]["name"], tx["value"])
const p = new URLSearchParams({
blockchain: "solana",
mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
limit: "50", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/tokens/transactions?${p}`);
const { data } = await res.json();
data.transactions.forEach(tx =>
console.log(tx.created_at, tx.transaction_type, tx.value));
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 transaction, newest first
Show transaction, newest first
Market cap at the moment of this trade in native currency (price per token times supply). Null if the supply is unknown.
Wallet profile of the trader (name, image_url, twitter, telegram, blockchain, currency, type).
{
"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
},
"transactions": [
{
"tx_signature": "5xr8abc...",
"transaction_type": "buy",
"value": 1.66,
"value_usd": 137.44,
"currency": "SOL",
"token_amount": 22113972.03,
"price_per_token": 7.5e-8,
"price_per_token_usd": 6.2e-6,
"market_cap": 75.0,
"market_cap_usd": 6200.0,
"created_at": "2026-07-04T16:25:34Z",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"holdings_after": {
"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
}
}
]
},
"pagination": {
"limit": 50,
"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"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | mint is missing. |
| 400 | invalid_parameter | blockchain, type or since invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

