List callouts

{
  "success": true,
  "data": [
    {
      "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "token": { "name": "invisibull", "symbol": "invisibull", "logo": "https://..." },
      "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
      },
      "note": "Dev still holding, chart is coiling.",
      "called_at": "2026-11-01T18:02:11Z",
      "window_ends_at": "2026-11-02T18:02:11Z",
      "status": "tracking",
      "at_call": { "price_usd": 0.0000412, "market_cap_usd": 41200.0 },
      "now": { "price_usd": 0.0000903, "market_cap_usd": 90300.0, "x": 2.2296, "at": "2026-11-03T09:40:00Z" },
      "peak": { "price_usd": 0.000131, "market_cap_usd": 131000.0, "x": 3.2346, "at": "2026-11-01T19:40:00Z" },
      "score_x": 3.2346,
      "source": "mobula",
      "tracking": {
        "active": true,
        "phase": "extended",
        "next_check_at": "2026-11-03T18:02:11Z",
        "below_10k_since": null,
        "daily_checks": 1,
        "stopped_at": null,
        "stop_reason": null
      },
      "first_day": {
        "kind": "candles",
        "entry_price_usd": 0.0000405,
        "peak_x": 3.2346,
        "close_x": 1.8642,
        "minutes_to_peak": 98,
        "flags": []
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-03T09:41:02Z"
  }
}

{
  "success": true,
  "data": [
    {
      "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "token": { "name": "invisibull", "symbol": "invisibull", "logo": "https://..." },
      "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
      },
      "note": "Dev still holding, chart is coiling.",
      "called_at": "2026-11-01T18:02:11Z",
      "window_ends_at": "2026-11-02T18:02:11Z",
      "status": "tracking",
      "at_call": { "price_usd": 0.0000412, "market_cap_usd": 41200.0 },
      "now": { "price_usd": 0.0000903, "market_cap_usd": 90300.0, "x": 2.2296, "at": "2026-11-03T09:40:00Z" },
      "peak": { "price_usd": 0.000131, "market_cap_usd": 131000.0, "x": 3.2346, "at": "2026-11-01T19:40:00Z" },
      "score_x": 3.2346,
      "source": "mobula",
      "tracking": {
        "active": true,
        "phase": "extended",
        "next_check_at": "2026-11-03T18:02:11Z",
        "below_10k_since": null,
        "daily_checks": 1,
        "stopped_at": null,
        "stop_reason": null
      },
      "first_day": {
        "kind": "candles",
        "entry_price_usd": 0.0000405,
        "peak_x": 3.2346,
        "close_x": 1.8642,
        "minutes_to_peak": 98,
        "flags": []
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "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.

GET /v1/callouts The callouts of your instance, newest first. Narrow them to one token, one user or a time range. Removed callouts are never returned.

Query Parameters

string

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

string

Only callouts on this token. Needs chain.

string

Only callouts of this user. Alternatively pass csid_id: a platform user, or a person who signed in to your app with CabalSpy ID (no thesis scope needed to read).

string

Only callouts made at or after this time, ISO 8601, for example 2026-11-01T00:00:00Z. Without a time zone UTC is assumed.

string

Only callouts made at or before this time, ISO 8601.

integer

default:"50"

Callouts per page, 1 to 200.

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?chain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

params = {"external_id": "user_8412", "limit": 20}
r = requests.get("https://api-id.cabalspy.xyz/v1/callouts", params=params,
                 headers={"Authorization": "Bearer YOUR_KEY"})
for c in r.json()["data"]:
    print(c["token"]["symbol"], c["called_at"], c["score_x"], c["status"])

const p = new URLSearchParams({ since: "2026-11-01T00:00:00Z", limit: "100" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/callouts?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data, pagination } = await res.json();
data.forEach(c => console.log(c.author.username, c.token.symbol, c.peak.x));

Response

array

Callout objects, newest first.

object

limit, has_more and next_cursor (pass it as cursor; null on the last page).

{
  "success": true,
  "data": [
    {
      "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "token": { "name": "invisibull", "symbol": "invisibull", "logo": "https://..." },
      "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
      },
      "note": "Dev still holding, chart is coiling.",
      "called_at": "2026-11-01T18:02:11Z",
      "window_ends_at": "2026-11-02T18:02:11Z",
      "status": "tracking",
      "at_call": { "price_usd": 0.0000412, "market_cap_usd": 41200.0 },
      "now": { "price_usd": 0.0000903, "market_cap_usd": 90300.0, "x": 2.2296, "at": "2026-11-03T09:40:00Z" },
      "peak": { "price_usd": 0.000131, "market_cap_usd": 131000.0, "x": 3.2346, "at": "2026-11-01T19:40:00Z" },
      "score_x": 3.2346,
      "source": "mobula",
      "tracking": {
        "active": true,
        "phase": "extended",
        "next_check_at": "2026-11-03T18:02:11Z",
        "below_10k_since": null,
        "daily_checks": 1,
        "stopped_at": null,
        "stop_reason": null
      },
      "first_day": {
        "kind": "candles",
        "entry_price_usd": 0.0000405,
        "peak_x": 3.2346,
        "close_x": 1.8642,
        "minutes_to_peak": 98,
        "flags": []
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "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	mint was passed without chain.
400	invalid_parameter	chain, mint, since, until, limit, cursor 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.

Chart markers

To show callouts on a token’s price chart, list them by chain and mint, with since and until set to the range the chart shows. Put a marker at called_at and at_call.price_usd for each, and show the author, note and score_x on hover. Page with cursor until has_more is false.

JavaScript

async function calloutMarkers(chain, mint, fromIso, toIso) {
  const markers = [];
  let cursor = null;
  do {
    const p = new URLSearchParams({ chain, mint, since: fromIso, until: toIso, limit: "200" });
    if (cursor) p.set("cursor", cursor);
    const res = await fetch(`https://api-id.cabalspy.xyz/v1/callouts?${p}`, {
      headers: { Authorization: "Bearer YOUR_KEY" },
    });
    const { data, pagination } = await res.json();
    for (const c of data) {
      markers.push({
        time: Date.parse(c.called_at) / 1000,
        price: c.at_call.price_usd,
        label: `${c.author.username ?? c.author.external_id}: ${c.score_x}x`,
      });
    }
    cursor = pagination.next_cursor;
  } while (cursor);
  return markers;
}

Call this from your backend, which holds the API key. To add new callouts while the chart is open, follow the callouts stream with the same chain and mint.

Get one callout

GET /v1/callouts/item One callout by id, as a callout object.

Query Parameters

string

required

The callout id.

string

required

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

cURL

curl "https://api-id.cabalspy.xyz/v1/callouts/item?id=5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer YOUR_KEY"

Errors

Status	Code	Meaning
400	missing_parameter	id is missing.
400	invalid_parameter	id is not a valid id.
403	feature_not_enabled	Callouts are not switched on for your instance.
404	callout_not_found	No callout with this id in your instance, or it was removed.

The callout object

string

The callout id.

string

The token’s chain and address.

object

name, symbol and logo of the token at the call. Any of them can be null.

object

Show author

string

The user’s CabalSpy ID.

string

Your id of the user, or null for users who are not platform users.

string

Display name, handle and avatar, if known.

boolean

Whether the user has the KOL badge.

string

The user’s note, or null.

string

When the callout was made.

string

End of the first 24 hours. Until then the user cannot call this token again.

string

tracking or final. See Statuses.

object

price_usd and market_cap_usd stamped at the call.

object

The latest price read: price_usd, market_cap_usd, x (against the entry) and at.

object

The highest price seen after the call: price_usd, market_cap_usd, x (against the entry) and at. Until a later price is seen, the entry price with x 1.0 and at the time of the call.

number

The callout’s score, its peak multiple. See Scoring.

string

The market data source of the prices.

object

Show tracking

boolean

Whether the callout is still tracked.

string

first_day (read every minute), extended (first day scored, read every 5 minutes) or stopped.

string

When the next day’s candles are added to the peak. Null in the first day and once stopped.

string

Since when the market cap has been below $10,000 (or the token has had no price) without interruption, or null. Tracking stops 24 hours after this time.

integer

Days scored so far, counting the first day.

string

When tracking stopped, or null.

string

Why tracking stopped: inactive (market cap below $10,000 for 24 hours) or no_price (no price for 24 hours). Null while tracked.

object

Only once the first day is scored: kind, entry_price_usd, peak_x, close_x, minutes_to_peak and flags. See The first day.

now.x, peak.x and score_x are measured against the entry price: the price at the call during the first day, the candle entry once the first day is scored with kind: "candles".

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Callouts

Reference

List callouts

List callouts

Query Parameters

Usage Example

Response

Errors

Chart markers

Get one callout

Query Parameters

Errors

The callout object

​List callouts

​Query Parameters

​Usage Example

​Response

​Errors

​Chart markers

​Get one callout

​Query Parameters

​Errors

​The callout object

List callouts

Query Parameters

Usage Example

Response

Errors

Chart markers

Get one callout

Query Parameters

Errors

The callout object