wallet_trust).
Query Parameters
string
required
Your id of the user. Alternatively pass csid_id.
string
default:"7d"
Window for the trading stats, one of 6h, 1d, 7d or 30d.
string
Your Instance ID. Only needed when your account has several instances.
string
required
Your API key. Alternatively pass it as an Authorization Bearer header.
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
object
The user object, plus:
Show profile fields
Show profile fields
string
The requested window.
array
One entry per chain the user has counting wallets on.
Show chain
Show chain
string
Chain.
string
Native currency of the chain.
string
The requested window.
number
Bought and sold, native and USD, summed over the user’s wallets on this chain.
number
Buy plus sell volume.
number
Realized PnL, native and USD.
integer
Trades, buys and sells.
number
Winning and closed positions, and the win rate over all wallets.
integer
Tokens traded in the period.
array
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.
array
The 20 newest trades over all the user’s counting wallets and chains, as in Latest trades, without
trader.object
total (visible theses of the user) and latest (up to 5, as in List theses).
object
traders (how many traders are in the user’s Trade Feed) and in_trade_feeds (how many people have the user in theirs).
object
badge and since, plus application: status, applied_at and note of the user’s KOL application, or null. See KOL badge.
array
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",
"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 or not enabled for CabalSpy ID. |
| 404 | platform_user_not_found | No user with this id in your instance. |
| 429 | rate_limit_exceeded | Rate limit exceeded. |