> 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/wallets-list.md).

# Wallets List

Lists all tracked wallets for a chain and wallet type, with cursor-based pagination. Each entry contains the wallet's profile (name, avatar, social links).

## List tracked wallets

> Returns all tracked wallets for the given chain and type.\
> \
> \*\*Parameters / settings\*\*\
> \- \`blockchain\` (required) — one of: \`solana\`, \`bnb\`, \`base\`, \`eth\`\
> \- \`type\` (required) — one of: \`kol\`, \`smart\`, \`whale\` (availability depends on chain)\
> \- \`limit\` (optional) — number of wallets to return. Omit it to get ALL wallets (no cap).\
> \- \`cursor\` (optional) — wallet address from a previous page for pagination\
> \- \`api\_key\` (optional if Bearer header is used)<br>

```json
{"openapi":"3.0.3","info":{"title":"CabalSpy API — Wallets List","version":"1.0.0"},"tags":[{"name":"Wallets List","description":"Lists all tracked wallets for a chain and wallet type, with cursor-based pagination. Each entry contains the wallet's profile (name, avatar, social links).\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":{"WalletsListEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"blockchain":{"type":"string"},"type":{"type":"string"},"currency":{"type":"string"},"pagination":{"type":"object"},"wallets":{"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/wallets":{"get":{"tags":["Wallets List"],"summary":"List tracked wallets","operationId":"listWallets","description":"Returns all tracked wallets for the given chain and type.\n\n**Parameters / settings**\n- `blockchain` (required) — one of: `solana`, `bnb`, `base`, `eth`\n- `type` (required) — one of: `kol`, `smart`, `whale` (availability depends on chain)\n- `limit` (optional) — number of wallets to return. Omit it to get ALL wallets (no cap).\n- `cursor` (optional) — wallet address from a previous page for pagination\n- `api_key` (optional if Bearer header is used)\n","parameters":[{"name":"blockchain","in":"query","required":true,"schema":{"type":"string","enum":["solana","bnb","base","eth"]}},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["kol","smart","whale"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"api_key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of wallets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletsListEnvelope"}}}},"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"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```