> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabalspy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform user profile

> GET /v1/platform-users/profile: everything for a profile page of one of your users in one call: wallets, trading stats per chain, recent trades, theses, KOL status and callout stats.

Everything you need for a profile page of one of your [platform users](https://docs.cabalspy.xyz/cabalspy-id/white-label.md), in one call: the [user object](https://docs.cabalspy.xyz/cabalspy-id/platform-users-get.md#response), trading stats for a period per chain and per wallet, the 20 most recent trades, the latest theses, Trade Feed counts, the KOL status, the callout stats when [callouts](https://docs.cabalspy.xyz/cabalspy-id/callouts.md) are switched on, and links to the detail endpoints of each wallet.

Only wallets that count are included: verified wallets and unverified wallets your instance accepts (`wallet_trust`).

## Query Parameters

**external\_id** `string` *required*

Your id of the user. Alternatively pass csid\_id.

**period** `string` (default: 7d)

Window for the trading stats, one of 6h, 1d, 7d or 30d.

**instance** `string`

Your Instance ID. Only needed when your account has several instances.

**api\_key** `string` *required*

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

## Usage Example

```bash cURL theme={null}
curl "https://api-id.cabalspy.xyz/v1/platform-users/profile?external_id=user_8412&period=7d" \
  -H "Authorization: Bearer YOUR_KEY"
```

```python Python theme={null}
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"], "%")
```

```javascript JavaScript theme={null}
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

**data** `object`

The [user object](https://docs.cabalspy.xyz/cabalspy-id/platform-users-get.md#response), plus:

**profile fields**

**period** `string`

The requested window.

**trading** `array`

One entry per chain the user has counting wallets on.

**chain**

**blockchain** `string`

Chain.

**currency** `string`

Native currency of the chain.

**period** `string`

The requested window.

**total\_buy, total\_buy\_usd, total\_sell, total\_sell\_usd** `number`

Bought and sold, native and USD, summed over the user's wallets on this chain.

**total\_volume, total\_volume\_usd** `number`

Buy plus sell volume.

**realized\_pnl, realized\_pnl\_usd** `number`

Realized PnL, native and USD.

**total\_txn, buy\_txn, sell\_txn** `integer`

Trades, buys and sells.

**win\_count, closed\_count, win\_rate\_percentage** `number`

Winning and closed positions, and the win rate over all wallets.

**tokens** `integer`

Tokens traded in the period.

**wallets** `array`

Per wallet with trades in the period: address, verified, the wallet's period stats (the period\_stats fields of the [leaderboard](https://docs.cabalspy.xyz/cabalspy-id/leaderboard.md)) and win\_rate\_percentage.

**recent\_trades** `array`

The 20 newest trades over all the user's counting wallets and chains, as in [Latest trades](https://docs.cabalspy.xyz/cabalspy-id/latest.md), without `trader`.

**theses** `object`

total (visible theses of the user) and latest (up to 5, as in [List theses](https://docs.cabalspy.xyz/cabalspy-id/theses-list.md#response)).

**trade\_feed** `object`

traders (how many traders are in the user's Trade Feed) and in\_trade\_feeds (how many people have the user in theirs).

**kol** `object`

badge and since, plus application: status, applied\_at and note of the user's KOL application, or null. See [KOL badge](https://docs.cabalspy.xyz/cabalspy-id/platform-users-kol.md).

**callouts** `object`

Only when [callouts](https://docs.cabalspy.xyz/cabalspy-id/callouts.md) are switched on for your instance: the user's callout record, as `data` of [Callout stats](https://docs.cabalspy.xyz/cabalspy-id/callouts-stats.md#response) 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`.

**links** `array`

Per counting wallet and chain: blockchain, address and the ready-made paths of [tracker](https://docs.cabalspy.xyz/cabalspy-id/tracker.md), [history](https://docs.cabalspy.xyz/cabalspy-id/history.md), [holdings](https://docs.cabalspy.xyz/cabalspy-id/holdings.md) and [pnl\_calendar](https://docs.cabalspy.xyz/cabalspy-id/pnl-calendar.md) for it.

```json Response theme={null}
{
  "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. |

See [Errors](https://docs.cabalspy.xyz/cabalspy-id/errors.md) for the full list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.