> 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)
```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"}}}}}}}}}
```
---
# 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, and the optional `goal` query parameter:
```
GET https://cabalspy.gitbook.io/cabalspy-docs/wallet-activity/wallet-connections.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.