Callout leaderboard

{
  "success": true,
  "data": {
    "period": "7d",
    "chain": null,
    "sort": "avg_peak_x",
    "hit_x": 2.0,
    "leaderboard": [
      {
        "callouts": 4,
        "avg_peak_x": 2.3911,
        "median_peak_x": 1.8273,
        "best_peak_x": 4.48,
        "sum_peak_x": 9.5644,
        "hits": 2,
        "hit_rate": 50.0,
        "best_call": {
          "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "symbol": "invisibull",
          "peak_x": 4.48
        },
        "rank": 1,
        "author": {
          "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
          "external_id": "user_8412",
          "name": "Maze",
          "username": "MazeCCC",
          "avatar_url": "https://cdn.example.com/avatars/8412.png",
          "kol": false
        },
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718"
      }
    ]
  },
  "pagination": {
    "limit": 100,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 12,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

{
  "success": true,
  "data": {
    "period": "7d",
    "chain": null,
    "sort": "avg_peak_x",
    "hit_x": 2.0,
    "leaderboard": [
      {
        "callouts": 4,
        "avg_peak_x": 2.3911,
        "median_peak_x": 1.8273,
        "best_peak_x": 4.48,
        "sum_peak_x": 9.5644,
        "hits": 2,
        "hit_rate": 50.0,
        "best_call": {
          "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "symbol": "invisibull",
          "peak_x": 4.48
        },
        "rank": 1,
        "author": {
          "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
          "external_id": "user_8412",
          "name": "Maze",
          "username": "MazeCCC",
          "avatar_url": "https://cdn.example.com/avatars/8412.png",
          "kol": false
        },
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718"
      }
    ]
  },
  "pagination": {
    "limit": 100,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 12,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

Callouts are switched on per instance on request. Contact us (contact@cabalspy.xyz) to enable them. Without them every endpoint answers 403 feature_not_enabled.

Every user of your instance who made callouts in the period, ranked. A period covers the callouts made in that window back from now, each counted with its current score. Each entry carries the user’s external_id, so you can render the leaderboard with your own user data.

The leaderboard is cached for 30 seconds. To page through it, pass pagination.next_cursor as cursor. An unknown or malformed cursor is answered with 400 invalid_parameter.

Query Parameters

string

default:"7d"

Ranking window, one of 6h, 1d, 7d or 30d.

string

Only callouts on this chain. One of solana, bnb, base, eth, rh. Empty means every chain.

string

default:"avg_peak_x"

Ranking order, highest first: avg_peak_x, median_peak_x, best_peak_x, sum_peak_x, hit_rate or callouts. Ties go to the user with more callouts.

integer

default:"1"

Callouts a user needs in the period to be listed, 1 to 1,000.

number

default:"2"

The multiple that counts as a hit, above 1 and at most 1000.

integer

default:"100"

Entries per page, 1 to 500.

string

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

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/callouts/leaderboard?period=7d&sort=avg_peak_x&min_callouts=3&limit=25" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

params = {"period": "30d", "sort": "hit_rate", "min_callouts": 5, "hit_x": 3}
r = requests.get("https://api-id.cabalspy.xyz/v1/callouts/leaderboard", params=params,
                 headers={"Authorization": "Bearer YOUR_KEY"})
for e in r.json()["data"]["leaderboard"]:
    print(e["rank"], e["author"]["external_id"], e["callouts"], e["hit_rate"], e["best_call"]["symbol"])

const p = new URLSearchParams({ period: "1d", chain: "solana", sort: "best_peak_x" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/callouts/leaderboard?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
data.leaderboard.forEach(e => console.log(e.rank, e.author?.username, e.best_peak_x));

Response

object

Show data

string

The values used. chain is null for every chain.

number

The hit multiple used.

array

Show entry

integer

Position, starting at 1.

string

The user’s CabalSpy ID.

object

csid_id, external_id, name, username, avatar_url and kol, as in the callout object.

integer

Callouts in the period.

number

Average, median, best and summed score.

number

Callouts that reached hit_x, and their percentage of the user’s callouts (0 to 100).

object

The user’s best callout in the period: id, chain, mint, symbol and peak_x.

object

limit, total (listed users), has_more and next_cursor (null means end).

{
  "success": true,
  "data": {
    "period": "7d",
    "chain": null,
    "sort": "avg_peak_x",
    "hit_x": 2.0,
    "leaderboard": [
      {
        "callouts": 4,
        "avg_peak_x": 2.3911,
        "median_peak_x": 1.8273,
        "best_peak_x": 4.48,
        "sum_peak_x": 9.5644,
        "hits": 2,
        "hit_rate": 50.0,
        "best_call": {
          "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "symbol": "invisibull",
          "peak_x": 4.48
        },
        "rank": 1,
        "author": {
          "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718",
          "external_id": "user_8412",
          "name": "Maze",
          "username": "MazeCCC",
          "avatar_url": "https://cdn.example.com/avatars/8412.png",
          "kol": false
        },
        "csid_id": "3f9a1c2e-5b7d-4e8f-a1b2-c3d4e5f60718"
      }
    ]
  },
  "pagination": {
    "limit": 100,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 12,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

Errors

Status	Code	Meaning
400	invalid_parameter	period, chain, sort, min_callouts, hit_x, limit or cursor invalid.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	feature_not_enabled	Callouts are not switched on for your instance.
429	rate_limit_exceeded	Rate limit exceeded.

See Errors for the full list.

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Callouts

Reference

Callout leaderboard

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors