Users

{
  "success": true,
  "data": [
    {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "bio": "onchain since 2020",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "x": {
        "id": "1440000000000000000",
        "followers": 48210,
        "following": 812,
        "verified": true,
        "verified_type": "blue"
      },
      "kol": { "badge": true, "since": "2026-10-10T12:00:00Z" },
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallets": [
        {
          "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
          "family": "solana",
          "chains": ["solana"],
          "verified_at": "2026-10-09T14:21:07Z"
        }
      ],
      "joined_at": "2026-10-09T14:02:51Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

{
  "success": true,
  "data": [
    {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "bio": "onchain since 2020",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "x": {
        "id": "1440000000000000000",
        "followers": 48210,
        "following": 812,
        "verified": true,
        "verified_type": "blue"
      },
      "kol": { "badge": true, "since": "2026-10-10T12:00:00Z" },
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallets": [
        {
          "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
          "family": "solana",
          "chains": ["solana"],
          "verified_at": "2026-10-09T14:21:07Z"
        }
      ],
      "joined_at": "2026-10-09T14:02:51Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

The people who signed in to your platform with CabalSpy ID, newest first. Each entry has the X profile, the KOL badge and the verified wallets. Only users within your plan’s user limit are listed. Users who signed in with Telegram or Google and have no X account have x and twitter set to null, see Users without X. Use it to sync your user base, to build a directory of verified traders, or to find every KOL on your platform with kol=true.

The list is paginated. Read pagination.next_cursor from the response and pass it back as cursor to fetch the next page. When next_cursor is null you have reached the end.

Query Parameters

integer

default:"50"

Users per page, 1 to 100.

string

true returns only users with the KOL badge.

string

Cursor for the next page, the pagination.next_cursor from the previous response.

string

default:"instance"

global lists every CabalSpy ID user. Enterprise plan only.

string

Your Instance ID. Only needed when your account has several instances.

string

required

Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

curl "https://api-id.cabalspy.xyz/v1/users?limit=50&kol=true" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

H = {"Authorization": "Bearer YOUR_KEY"}
params = {"limit": 100}
while True:
    r = requests.get("https://api-id.cabalspy.xyz/v1/users", params=params, headers=H).json()
    for u in r["data"]:
        print(u["username"], u["kol"]["badge"], len(u["wallets"]), "wallets")
    if not r["pagination"]["next_cursor"]:
        break
    params["cursor"] = r["pagination"]["next_cursor"]

const p = new URLSearchParams({ limit: "50", kol: "true" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/users?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data, pagination } = await res.json();
data.forEach(u => console.log(u.username, u.wallets.length));

Response

boolean

True on success.

array

Show user

string

The user’s id, the sub of their ID token.

string

X handle, or tg.<telegram username> / id.<10 hex characters> for users without X.

string

Display name.

string

Avatar URL.

string

X bio, null without X.

string

X profile link, null without X.

string

Link to the verified Telegram account (https://t.me/<username>), or an empty string.

object

X account: id, followers, following, verified, verified_type. Null without X.

object

badge (boolean) and since (ISO timestamp the badge was granted, or null).

string

Public CabalSpy ID profile.

array

Verified wallets: address, family, chains, verified_at.

string

When the CabalSpy ID was created.

object

Show pagination

integer

Users per page.

integer

Total users matching the filter.

boolean

Whether more pages follow.

string

Cursor for the next page (null means end).

{
  "success": true,
  "data": [
    {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "bio": "onchain since 2020",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "x": {
        "id": "1440000000000000000",
        "followers": 48210,
        "following": 812,
        "verified": true,
        "verified_type": "blue"
      },
      "kol": { "badge": true, "since": "2026-10-10T12:00:00Z" },
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC",
      "wallets": [
        {
          "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
          "family": "solana",
          "chains": ["solana"],
          "verified_at": "2026-10-09T14:21:07Z"
        }
      ],
      "joined_at": "2026-10-09T14:02:51Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

Errors

Status	Code	Meaning
400	invalid_parameter	limit, cursor or scope invalid.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	scope_not_allowed	scope=global needs the Enterprise plan.
429	rate_limit_exceeded	Rate limit exceeded.

See Errors for the full list.

Introduction

Login

Data API

Trading

Theses

Streams

Reference

Users

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors