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

get

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)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

addressstringRequiredExample: G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC

limitinteger · min: 1Optional

Max number of connections. If omitted, all connections are returned.

Example: 50

api_keystringOptionalExample: YOUR_KEY

Responses

200

Connections returned (may be an empty list).

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter.

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

429

Rate limit exceeded.

application/json

get

/v1/wallets/connections

HTTPcURLJavaScriptPython

GET /v1/wallets/connections?blockchain=solana&address=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "wallet_address": "G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC",
    "blockchain": "solana",
    "connections": [
      {
        "wallet_address": "7xKp...9aBc",
        "name": "Orange",
        "image_url": "https://cabalspy.xyz/images/orange.png",
        "twitter": "@Orange",
        "type": "kol",
        "shared_tokens": 8,
        "overlap_score": 0.32
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "version": "1.0.0",
    "timestamp": "2025-03-19T14:22:30Z"
  }
}