> ## 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.

# KOL Wallet Tracking

> Turn a wallet address into a full profile with stats, realized PnL, holdings and a PnL calendar. Endpoints, chains, first steps and a cookbook.

Turn a single wallet address into a full profile, the trader stats, realized PnL, the tokens they traded, live holdings and a month by month PnL calendar. It is the detail page behind every KOL you follow, everything one wallet has done over a period in one view.

## What it shows

A trader name and labels, their realized PnL and win rate, average hold time, the tokens they are in and the trades they made. Use it as a KOL profile card, a copytrade research page, or the wallet detail view in a terminal.

## Blockchains

Solana, BNB, Base, ETH and Robinhood.

## Endpoints

The tracking call carries the whole profile. Two more calls add live holdings and the calendar.

<CardGroup cols={1}>
  <Card title="GET /v1/wallet/tracking" href="https://docs.cabalspy.xyz/tracker">
    Profile, period stats, win rate, traded tokens, the realized PnL series and recent trades.
  </Card>

  <Card title="GET /v1/wallet/holdings" href="https://docs.cabalspy.xyz/holdings">
    Current on-chain token balances.
  </Card>

  <Card title="GET /v1/wallet/pnl_calendar" href="https://docs.cabalspy.xyz/pnl-calender">
    Day by day realized PnL, grouped by month.
  </Card>
</CardGroup>

## First steps

<Steps>
  <Step title="Get an API key">
    Register at [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz) and create a key. The free tier is enough to start.
  </Step>

  <Step title="Pick a wallet and chain">
    You need a wallet address and its chain, one of solana, bnb, base, eth or robinhood.
  </Step>

  <Step title="Call the tracking endpoint">
    Pass blockchain, address, period and your api\_key. The response carries the full profile in one call.
  </Step>
</Steps>

```bash Quick test theme={null}
curl "https://api.cabalspy.xyz/v1/wallet/tracking?blockchain=solana&address=YOUR_WALLET&period=30d&api_key=YOUR_KEY"
```

## Build it

<CardGroup cols={2}>
  <Card title="Cookbook, Wallet Tracker" href="https://docs.cabalspy.xyz/build-a-wallet-tracker-like-axiom">
    Build the full profile page and PnL calendar step by step.
  </Card>

  <Card title="GitHub demo" icon="github" href="https://github.com/CabalSpy/Wallet-Tracker-Demo">
    Open-source, run in minutes.
  </Card>
</CardGroup>