> 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-connections.md).

# Wallet Connections

Finds other tracked wallets that share tokens with the given wallet over the last 30 days. Connections are ranked by the number of shared tokens. An overlap score expresses how much of the source wallet's token set is shared with each connection.

## Find wallets that share tokens with a wallet

> Compares the source wallet's 30-day token set against other tracked wallets on the same chain and returns those with overlapping tokens, sorted by shared-token count (most first).\
> \
> \*\*Parameters\*\*\
> \- \`blockchain\` (required) — one of: \`solana\`, \`bnb\`, \`base\`, \`eth\`\
> \- \`address\` (required) — source wallet address\
> \- \`limit\` (optional) — max number of connections to return; if omitted, all are returned\
> \- \`api\_key\` (optional if Bearer header is used)<br>

```json
{"openapi":"3.0.3","info":{"title":"CabalSpy API — Wallet Connections","version":"1.0.0"},"tags":[{"name":"Wallet Connections","description":"Finds other tracked wallets that share tokens with the given wallet over the last 30 days. Connections are ranked by the number of shared tokens. An overlap score expresses how much of the source wallet's token set is shared with each connection.\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":{"WalletConnectionsEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"wallet_address":{"type":"string","description":"The source wallet."},"blockchain":{"type":"string","enum":["solana","bnb","base","eth"]},"connections":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"meta":{"type":"object"}}},"Connection":{"type":"object","properties":{"wallet_address":{"type":"string"},"name":{"type":"string"},"image_url":{"type":"string"},"twitter":{"type":"string"},"type":{"type":"string","description":"Wallet category (kol / smart / whale)."},"shared_tokens":{"type":"integer","description":"Number of tokens both wallets traded in the last 30 days."},"overlap_score":{"type":"number","description":"shared_tokens divided by the source wallet's token count (0–1)."}}},"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/connections":{"get":{"tags":["Wallet Connections"],"summary":"Find wallets that share tokens with a wallet","operationId":"getWalletConnections","description":"Compares the source wallet's 30-day token set against other tracked wallets on the same chain and returns those with overlapping tokens, sorted by shared-token count (most first).\n\n**Parameters**\n- `blockchain` (required) — one of: `solana`, `bnb`, `base`, `eth`\n- `address` (required) — source wallet address\n- `limit` (optional) — max number of connections to return; if omitted, all are returned\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":"address","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max number of connections. If omitted, all connections are returned.","schema":{"type":"integer","minimum":1}},{"name":"api_key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Connections returned (may be an empty list).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletConnectionsEnvelope"}}}},"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"}}}}}}}}}
```