Callout stats

{
  "success": true,
  "data": {
    "user": {
      "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
    },
    "hit_x": 2.0,
    "periods": {
      "6h": { "callouts": 0, "avg_peak_x": null, "median_peak_x": null, "best_peak_x": null, "sum_peak_x": 0.0, "hits": 0, "hit_rate": 0.0, "avg_now_x": null, "tracking": 0 },
      "1d": { "callouts": 1, "avg_peak_x": 1.42, "median_peak_x": 1.42, "best_peak_x": 1.42, "sum_peak_x": 1.42, "hits": 0, "hit_rate": 0.0, "avg_now_x": 1.1, "tracking": 1 },
      "7d": { "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, "avg_now_x": 1.0412, "tracking": 3 },
      "30d": { "callouts": 11, "avg_peak_x": 2.0127, "median_peak_x": 1.61, "best_peak_x": 4.48, "sum_peak_x": 22.1397, "hits": 4, "hit_rate": 36.36, "avg_now_x": 0.7215, "tracking": 5 }
    },
    "callouts_all_time": 23
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

{
  "success": true,
  "data": {
    "user": {
      "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
    },
    "hit_x": 2.0,
    "periods": {
      "6h": { "callouts": 0, "avg_peak_x": null, "median_peak_x": null, "best_peak_x": null, "sum_peak_x": 0.0, "hits": 0, "hit_rate": 0.0, "avg_now_x": null, "tracking": 0 },
      "1d": { "callouts": 1, "avg_peak_x": 1.42, "median_peak_x": 1.42, "best_peak_x": 1.42, "sum_peak_x": 1.42, "hits": 0, "hit_rate": 0.0, "avg_now_x": 1.1, "tracking": 1 },
      "7d": { "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, "avg_now_x": 1.0412, "tracking": 3 },
      "30d": { "callouts": 11, "avg_peak_x": 2.0127, "median_peak_x": 1.61, "best_peak_x": 4.48, "sum_peak_x": 22.1397, "hits": 4, "hit_rate": 36.36, "avg_now_x": 0.7215, "tracking": 5 }
    },
    "callouts_all_time": 23
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "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.

One user’s callout record, for four periods at once: 6h, 1d, 7d and 30d. A period covers the callouts the user made in that window back from now, each counted with its current score, so a callout from yesterday that keeps rising improves the 1d, 7d and 30d numbers. The same block is part of the platform user profile as callouts, with the default hit_x of 2.

Query Parameters

string

required

Your id of the user. Alternatively pass csid_id: a platform user, or a person who signed in to your app with CabalSpy ID (no thesis scope needed).

number

default:"2"

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

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/stats?external_id=user_8412&hit_x=3" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

d = requests.get("https://api-id.cabalspy.xyz/v1/callouts/stats",
                 params={"external_id": "user_8412"},
                 headers={"Authorization": "Bearer YOUR_KEY"}).json()["data"]
for period, s in d["periods"].items():
    print(period, s["callouts"], s["avg_peak_x"], f'{s["hit_rate"]}% hit {d["hit_x"]}x')

const p = new URLSearchParams({ external_id: "user_8412" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/callouts/stats?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
console.log(data.periods["7d"].avg_peak_x, data.callouts_all_time);

Response

object

Show data

object

The user: csid_id, external_id, name, username, avatar_url and kol, as author in the callout object.

number

The hit multiple used.

object

One entry each for 6h, 1d, 7d and 30d.

Show period

integer

Callouts made in the period.

number

Average, median and best score. Null without callouts.

number

Sum of the scores.

integer

Callouts whose score reached hit_x.

number

Hits as a percentage of callouts, 0 to 100.

number

Average current multiple: the latest price against the entry, the same entry as now.x in the callout object. Null without a price read.

integer

How many of these callouts are still tracked.

integer

All callouts of the user on your instance, removed ones excluded.

{
  "success": true,
  "data": {
    "user": {
      "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
    },
    "hit_x": 2.0,
    "periods": {
      "6h": { "callouts": 0, "avg_peak_x": null, "median_peak_x": null, "best_peak_x": null, "sum_peak_x": 0.0, "hits": 0, "hit_rate": 0.0, "avg_now_x": null, "tracking": 0 },
      "1d": { "callouts": 1, "avg_peak_x": 1.42, "median_peak_x": 1.42, "best_peak_x": 1.42, "sum_peak_x": 1.42, "hits": 0, "hit_rate": 0.0, "avg_now_x": 1.1, "tracking": 1 },
      "7d": { "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, "avg_now_x": 1.0412, "tracking": 3 },
      "30d": { "callouts": 11, "avg_peak_x": 2.0127, "median_peak_x": 1.61, "best_peak_x": 4.48, "sum_peak_x": 22.1397, "hits": 4, "hit_rate": 36.36, "avg_now_x": 0.7215, "tracking": 5 }
    },
    "callouts_all_time": 23
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

Errors

Status	Code	Meaning
400	missing_parameter	external_id (or csid_id) is missing.
400	invalid_parameter	hit_x or csid_id 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.
404	platform_user_not_found	No platform user with this external_id, and no user of your app with this csid_id.
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

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors