PnL Calendar
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendarimport requests
url = "https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar', 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/wallet/pnl_calendar",
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/wallet/pnl_calendar"
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/wallet/pnl_calendar")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar")
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": {
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"months": [
{
"dates": [
{
"date": "04-07-26",
"realized_pnl": 12.4,
"realized_pnl_usd": 1020.6,
"buy_txn": 6,
"sell_txn": 5,
"txn_total": 11,
"tokens_traded": 4,
"volume": 88.5,
"total_buy": 50.25,
"total_buy_usd": 4137.6,
"total_sell": 38.25,
"total_sell_usd": 3150.4
}
],
"month": {
"month": 7,
"year": 2026,
"positive_streak": 3,
"negative_streak": 1,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"volume": 312.5,
"buy_txn": 22,
"sell_txn": 18,
"txn_total": 40,
"tokens_traded": 23,
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 132.25,
"total_sell_usd": 10890.65
}
}
],
"dates": [],
"month": {}
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Wallet data
PnL Calendar
Day by day realized PnL calendar for a wallet, grouped by month, with per day profit and loss, volume, trade counts and win loss streaks.
GET
/
v1
/
wallet
/
pnl_calendar
PnL Calendar
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendarimport requests
url = "https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar', 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/wallet/pnl_calendar",
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/wallet/pnl_calendar"
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/wallet/pnl_calendar")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/wallet/pnl_calendar")
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": {
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"months": [
{
"dates": [
{
"date": "04-07-26",
"realized_pnl": 12.4,
"realized_pnl_usd": 1020.6,
"buy_txn": 6,
"sell_txn": 5,
"txn_total": 11,
"tokens_traded": 4,
"volume": 88.5,
"total_buy": 50.25,
"total_buy_usd": 4137.6,
"total_sell": 38.25,
"total_sell_usd": 3150.4
}
],
"month": {
"month": 7,
"year": 2026,
"positive_streak": 3,
"negative_streak": 1,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"volume": 312.5,
"buy_txn": 22,
"sell_txn": 18,
"txn_total": 40,
"tokens_traded": 23,
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 132.25,
"total_sell_usd": 10890.65
}
}
],
"dates": [],
"month": {}
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
A day by day realized PnL calendar for a wallet, grouped by month. Each day carries the realized PnL, volume, buy and sell counts and how many distinct tokens were traded. Each month adds a summary with totals and the longest winning and losing day streaks.
Use it to render a heatmap style trading calendar on a wallet profile, the kind that shows green and red days at a glance. Months are returned oldest first, and the current month updates continuously.
The response includes months, an array of all months oldest first, plus dates and month for the current month at the top level for convenience. Each day date uses the format DD-MM-YY, for example 04-07-26.
Query Parameters
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/wallet/pnl_calendar?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana",
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/wallet/pnl_calendar", params=params)
d = r.json()["data"]
for month in d["months"]:
m = month["month"]
print(m["year"], m["month"], "pnl", m["realized_pnl"], "streak", m["positive_streak"])
for day in month["dates"]:
print(" ", day["date"], day["realized_pnl"])
const p = new URLSearchParams({
blockchain: "solana",
address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/wallet/pnl_calendar?${p}`);
const { data } = await res.json();
data.months.forEach(month =>
month.dates.forEach(day => console.log(day.date, day.realized_pnl)));
Response
Show data
Show data
Show month
Show month
Show day
Show day
Show month summary
Show month summary
{
"success": true,
"data": {
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"months": [
{
"dates": [
{
"date": "04-07-26",
"realized_pnl": 12.4,
"realized_pnl_usd": 1020.6,
"buy_txn": 6,
"sell_txn": 5,
"txn_total": 11,
"tokens_traded": 4,
"volume": 88.5,
"total_buy": 50.25,
"total_buy_usd": 4137.6,
"total_sell": 38.25,
"total_sell_usd": 3150.4
}
],
"month": {
"month": 7,
"year": 2026,
"positive_streak": 3,
"negative_streak": 1,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"volume": 312.5,
"buy_txn": 22,
"sell_txn": 18,
"txn_total": 40,
"tokens_traded": 23,
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 132.25,
"total_sell_usd": 10890.65
}
}
],
"dates": [],
"month": {}
},
"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 | address is missing. |
| 400 | invalid_parameter | blockchain missing or invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

