> 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.
```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"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://cabalspy.gitbook.io/cabalspy-docs/wallet-activity/wallet-tracker.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.