> For the complete documentation index, see [llms.txt](https://cabalspy.gitbook.io/cabalspy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cabalspy.gitbook.io/cabalspy-docs/wallet-activity/wallet-tracker.md).

# Wallet Tracker

Returns a tracked wallet's full trading profile for the requested period: profile (incl. typical active trading hours over 30d), period\_stats (native + USD, win rate, avg hold time), win-rate distribution, tokens traded in the period, token history, a downsampled realized-PnL chart and the individual trades. Current on-chain holdings are served by the separate `GET /v1/wallet/holdings` endpoint.

## Get wallet trading profile

> The wallet category (kol / smart / whale) is detected automatically. Only wallets that appear in a leaderboard are tracked — unknown addresses return \`404\`.\
> \
> \*\*Parameters / settings\*\*\
> \- \`blockchain\` (required) — one of: \`solana\`, \`bnb\`, \`base\`, \`eth\`\
> \- \`address\` (required) — wallet address (Solana base58 or \`0x…\` for EVM chains)\
> \- \`period\` (optional, default \`1d\`) — one of: \`6h\`, \`1d\`, \`7d\`, \`30d\`\
> \- \`api\_key\` (optional if Bearer header is used)\
> \
> Alias: \`GET /v1/wallets/tracker\` is identical.<br>

```json
{"openapi":"3.0.3","info":{"title":"CabalSpy API — Wallet Tracker","version":"1.0.0"},"tags":[{"name":"Wallet Tracker","description":"Returns a tracked wallet's full trading profile for the requested period: profile (incl. typical active trading hours over 30d), period_stats (native + USD, win rate, avg hold time), win-rate distribution, tokens traded in the period, token history, a downsampled realized-PnL chart and the individual trades. Current on-chain holdings are served by the separate `GET /v1/wallet/holdings` endpoint.\n"}],"servers":[{"url":"https://api.cabalspy.xyz"}],"security":[{"bearerAuth":[]},{"apiKeyQuery":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer YOUR_KEY"},"apiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"}},"schemas":{"WalletTrackingEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"wallet":{"type":"string"},"profile":{"type":"object"},"period_stats":{"type":"object"},"period_win_rate_distribution":{"type":"object"},"period_active_tokens":{"type":"object"},"period_history_tokens":{"type":"array","items":{"type":"object"}},"period_realized_pnl_chart":{"type":"array","items":{"type":"object"}},"period_trades":{"type":"array","items":{"type":"object"}}}},"meta":{"type":"object"}}},"ErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"docs":{"type":"string"}}}}}}},"paths":{"/v1/wallet/tracking":{"get":{"tags":["Wallet Tracker"],"summary":"Get wallet trading profile","operationId":"getWalletTracking","description":"The wallet category (kol / smart / whale) is detected automatically. Only wallets that appear in a leaderboard are tracked — unknown addresses return `404`.\n\n**Parameters / settings**\n- `blockchain` (required) — one of: `solana`, `bnb`, `base`, `eth`\n- `address` (required) — wallet address (Solana base58 or `0x…` for EVM chains)\n- `period` (optional, default `1d`) — one of: `6h`, `1d`, `7d`, `30d`\n- `api_key` (optional if Bearer header is used)\n\nAlias: `GET /v1/wallets/tracker` is identical.\n","parameters":[{"name":"blockchain","in":"query","required":true,"schema":{"type":"string","enum":["solana","bnb","base","eth"]}},{"name":"address","in":"query","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["6h","1d","7d","30d"],"default":"1d"}},{"name":"api_key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet found — returns full trading profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletTrackingEnvelope"}}}},"400":{"description":"Missing or invalid parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Invalid or exhausted API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Wallet not tracked on this chain.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```