Connections
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/wallets/connectionsimport requests
url = "https://demo-api.cabalspy.xyz/v1/wallets/connections"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/wallets/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/wallets/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://demo-api.cabalspy.xyz/v1/wallets/connections"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/wallets/connections")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/wallets/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"blockchain": "solana",
"connections": [
{
"wallet_address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"name": "Cupsey",
"image_url": "https://cabalspy.xyz/images/9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin.png",
"twitter": "https://x.com/cupseyy",
"type": "kol",
"shared_tokens": 18,
"overlap_score": 0.375
},
{
"wallet_address": "3Cx7Wm8yQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZbXX",
"name": "",
"image_url": "",
"twitter": "",
"type": "kol",
"shared_tokens": 9,
"overlap_score": 0.187
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 120,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Wallet data
Connections
Find wallets connected to a given wallet by shared token activity, ranked by how many tokens they traded in common over the last 30 days.
GET
/
v1
/
wallets
/
connections
Connections
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/wallets/connectionsimport requests
url = "https://demo-api.cabalspy.xyz/v1/wallets/connections"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/wallets/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/wallets/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://demo-api.cabalspy.xyz/v1/wallets/connections"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/wallets/connections")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/wallets/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"blockchain": "solana",
"connections": [
{
"wallet_address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"name": "Cupsey",
"image_url": "https://cabalspy.xyz/images/9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin.png",
"twitter": "https://x.com/cupseyy",
"type": "kol",
"shared_tokens": 18,
"overlap_score": 0.375
},
{
"wallet_address": "3Cx7Wm8yQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZbXX",
"name": "",
"image_url": "",
"twitter": "",
"type": "kol",
"shared_tokens": 9,
"overlap_score": 0.187
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 120,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Discover which other tracked wallets trade the same tokens as a given wallet. CabalSpy compares the tokens the wallet traded over the last 30 days against every other tracked wallet of the same type and returns those with overlap, ranked by how many tokens they share.
Use it to map clusters of wallets that move together, spot wallets that shadow a known KOL, or surface a network of related traders around one address.
overlap_score is the share of the source wallet tokens that the other wallet also traded, from 0 to 1. A higher shared_tokens count and a higher overlap_score mean a stronger connection. Results are sorted by shared_tokens, highest first.
Query Parameters
Your API key, required on
https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.Try it without an API key: Try it runs on the demo server
https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demoUsage Example
curl "https://api.cabalspy.xyz/v1/wallets/connections?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW&limit=20&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana",
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"limit": 20, "api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/wallets/connections", params=params)
for c in r.json()["data"]["connections"]:
print(c["name"] or c["wallet_address"], "shared", c["shared_tokens"], "score", c["overlap_score"])
const p = new URLSearchParams({
blockchain: "solana",
address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
limit: "20", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/wallets/connections?${p}`);
const { data } = await res.json();
data.connections.forEach(c =>
console.log(c.name || c.wallet_address, "shared", c.shared_tokens));
Response
Show data
Show data
Show connection, sorted by shared_tokens highest first
Show connection, sorted by shared_tokens highest first
{
"success": true,
"data": {
"wallet_address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"blockchain": "solana",
"connections": [
{
"wallet_address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"name": "Cupsey",
"image_url": "https://cabalspy.xyz/images/9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin.png",
"twitter": "https://x.com/cupseyy",
"type": "kol",
"shared_tokens": 18,
"overlap_score": 0.375
},
{
"wallet_address": "3Cx7Wm8yQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZbXX",
"name": "",
"image_url": "",
"twitter": "",
"type": "kol",
"shared_tokens": 9,
"overlap_score": 0.187
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 120,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | address is missing. |
| 400 | invalid_parameter | blockchain missing or invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

