wallet_trust).
Query Parameters
Usage Example
curl "https://api-id.cabalspy.xyz/v1/platform-users/profile?external_id=user_8412&period=7d" \
-H "Authorization: Bearer YOUR_KEY"
import requests
r = requests.get("https://api-id.cabalspy.xyz/v1/platform-users/profile",
params={"external_id": "user_8412", "period": "30d"},
headers={"Authorization": "Bearer YOUR_KEY"})
p = r.json()["data"]
for t in p["trading"]:
print(t["blockchain"], t["realized_pnl_usd"], t["win_rate_percentage"], "%")
const p = new URLSearchParams({ external_id: "user_8412", period: "7d" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/platform-users/profile?${p}`, {
headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
console.log(data.display_name, data.trading, data.recent_trades.length);
Response
The user object, plus:
Show profile fields
Show profile fields
One entry per chain the user has counting wallets on.
Show chain
Show chain
Per wallet with trades in the period: address, verified, the wallet’s period stats (the period_stats fields of the leaderboard) and win_rate_percentage.
The 20 newest trades over all the user’s counting wallets and chains, as in Latest trades, without
trader.total (visible theses of the user) and latest (up to 5, as in List theses).
traders (how many traders are in the user’s Trade Feed) and in_trade_feeds (how many people have the user in theirs).
badge and since, plus application: status, applied_at and note of the user’s KOL application, or null. See KOL badge.
Only when callouts are switched on for your instance: the user’s callout record, as
data of Callout stats without user, with hit_x 2: hit_x, periods (6h, 1d, 7d and 30d, each with callouts, avg_peak_x, median_peak_x, best_peak_x, sum_peak_x, hits, hit_rate in percent, avg_now_x and tracking) and callouts_all_time. Not affected by period.Per counting wallet and chain: blockchain, address and the ready-made paths of tracker, history, holdings and pnl_calendar for it.
{
"success": true,
"data": {
"csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
"external_id": "user_8412",
"self_managed": false,
"self_managed_at": null,
"merged_from": null,
"claimed": false,
"claimed_at": null,
"managed": true,
"display_name": "Maze",
"avatar_url": "https://cdn.example.com/avatars/8412.png",
"limited": false,
"x": null,
"telegram": null,
"kol": {
"badge": false,
"since": null,
"application": null
},
"wallets": [
{
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"family": "solana",
"chains": ["solana"],
"verified": false,
"verified_chains": [],
"status": "active",
"counts": true,
"source": "privy",
"verified_at": null,
"added_at": "2026-10-24T09:12:40Z"
}
],
"pending_verifications": [],
"created_at": "2026-10-24T09:12:40Z",
"period": "7d",
"trading": [
{
"blockchain": "solana",
"currency": "SOL",
"period": "7d",
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 228.45,
"total_sell_usd": 18809.2,
"total_volume": 408.7,
"total_volume_usd": 33649.8,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"total_txn": 40,
"buy_txn": 22,
"sell_txn": 18,
"win_count": 14,
"closed_count": 18,
"win_rate_percentage": 77.78,
"tokens": 21,
"wallets": [
{
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"verified": false,
"period": "7d",
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 228.45,
"total_sell_usd": 18809.2,
"total_volume": 408.7,
"total_volume_usd": 33649.8,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"realized_pnl_percentage": 26.74,
"avg_hold_time_minutes": 84.5,
"total_txn": 40,
"buy_txn": 22,
"sell_txn": 18,
"win_rate_percentage": 77.78
}
]
}
],
"recent_trades": [
{
"signature": "5xr8abc...",
"blockchain": "solana",
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"transaction_type": "buy",
"token_symbol": "invisibull",
"token_name": "invisibull",
"token_logo": "https://...",
"token_amount": 22113972.03,
"value": 1.66,
"value_usd": 137.44,
"currency": "SOL",
"timestamp": "2026-10-26T08:03:58Z"
}
],
"theses": { "total": 0, "latest": [] },
"trade_feed": { "traders": 3, "in_trade_feeds": 12 },
"links": [
{
"blockchain": "solana",
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"tracker": "/v1/wallets/tracker?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&period=7d",
"history": "/v1/wallets/history?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"holdings": "/v1/wallets/holdings?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"pnl_calendar": "/v1/wallets/pnl_calendar?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "v1",
"timestamp": "2026-10-26T08:04:11Z"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | external_id missing. |
| 400 | invalid_parameter | period, external_id or csid_id invalid. |
| 401 | missing_api_key | API key missing. |
| 403 | invalid_api_key | API key invalid. |
| 403 | product_not_enabled | The key is not enabled for the CabalSpy ID API (API keys page, Works with). |
| 404 | platform_user_not_found | No user with this id in your instance. |
| 429 | rate_limit_exceeded | Rate limit exceeded. |

