Make and remove 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.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "peak": { "price_usd": 0.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "score_x": 1.0,
    "source": "mobula",
    "tracking": {
      "active": true,
      "phase": "first_day",
      "next_check_at": null,
      "below_10k_since": null,
      "daily_checks": 0,
      "stopped_at": null,
      "stop_reason": null
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-01T18:02:11Z"
  }
}

{
  "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.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "peak": { "price_usd": 0.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "score_x": 1.0,
    "source": "mobula",
    "tracking": {
      "active": true,
      "phase": "first_day",
      "next_check_at": null,
      "below_10k_since": null,
      "daily_checks": 0,
      "stopped_at": null,
      "stop_reason": null
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-01T18:02:11Z"
  }
}

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.

Make a callout

POST /v1/callouts Makes a callout on a token in the name of one of your users, from your backend. The token’s current price and market cap are stamped on it and tracking starts at once. A callout.created event goes out on the stream and as a webhook.

Your instance’s settings decide who can call: everyone or KOLs only, holders only (the default), and a cooldown between two callouts of a user (6 hours by default). A user can call the same token once per 24 hours.

Take the user’s id from your own session, never from the browser request: whoever controls it makes callouts in that user’s name.

Body

Send JSON with Content-Type: application/json.

string

required

Your id of the user, a platform user. Alternatively pass csid_id.

string

The user’s CabalSpy ID: a platform user, or a person who signed in to your app with the scope thesis.

string

required

Chain of the token. One of solana, bnb, base, eth, rh.

string

required

Token address: a Solana mint or a 0x contract address.

string

Optional text shown with the callout, up to 280 characters. Whitespace is collapsed, at most one link, no blocked words.

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 -X POST "https://api-id.cabalspy.xyz/v1/callouts" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "user_8412",
    "chain": "solana",
    "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    "note": "Dev still holding, chart is coiling."
  }'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/callouts", json={
    "external_id": "user_8412",
    "chain": "solana",
    "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    "note": "Dev still holding, chart is coiling.",
}, headers={"Authorization": "Bearer YOUR_KEY"})
if r.status_code == 429:
    print("cooldown, retry in", r.headers["Retry-After"], "seconds")
else:
    c = r.json()["data"]
    print(c["id"], c["at_call"]["price_usd"], c["at_call"]["market_cap_usd"])

const res = await fetch("https://api-id.cabalspy.xyz/v1/callouts", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    external_id: "user_8412",
    chain: "solana",
    mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
  }),
});
const body = await res.json();
if (!body.success) console.error(body.error.code, body.error.message);
else console.log(body.data.id, body.data.at_call);

Response

201 with the callout object, as in List callouts. Right after the call, now and peak equal the price at the call, and peak.x and score_x are exactly 1.0.

{
  "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.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "peak": { "price_usd": 0.0000412, "market_cap_usd": 41200.0, "x": 1.0, "at": "2026-11-01T18:02:11Z" },
    "score_x": 1.0,
    "source": "mobula",
    "tracking": {
      "active": true,
      "phase": "first_day",
      "next_check_at": null,
      "below_10k_since": null,
      "daily_checks": 0,
      "stopped_at": null,
      "stop_reason": null
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-11-01T18:02:11Z"
  }
}

Errors

The checks run in this order, so the first rule a callout breaks is the one you see. Messages are written for end users, you can show them as they are.

Status	Code	Meaning
400	missing_parameter	chain, mint or external_id (or csid_id) is missing.
400	invalid_parameter	Unknown chain, invalid token address, invalid csid_id, or a note that is too long, has more than one link or a blocked word. `parameter` names it.
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.
403	consent_required	A csid_id that is not a platform user has not granted your app the scope thesis.
403	plan_user_limit	The user is beyond your plan’s user limit.
403	sandbox_user	Sandbox test users cannot make callouts.
403	invalid_account	The user’s account is not active.
403	kol_only	Only users with the KOL badge can call on your platform.
403	posting_paused	The user is paused from writing.
403	not_a_holder	Holders only: the user does not hold the token.
409	already_called	The user called this token less than 24 hours ago.
429	callout_cooldown	The user’s cooldown is running. `Retry-After` says how many seconds are left.
422	no_price	The token has no market price yet.
503	service_unavailable	The price could not be read right now. Retry in a moment.
429	rate_limit_exceeded	Your API key’s request rate is exceeded.

callout_cooldown

{
  "success": false,
  "error": {
    "code": "callout_cooldown",
    "message": "One callout every 360 minutes; next one in 118 minutes.",
    "request_id": "req_5162c7cf7f87",
    "docs": "https://docs.cabalspy.xyz/cabalspy-id/errors#callout_cooldown",
    "retry_after": 7051
  }
}

Remove a callout

POST /v1/callouts/remove Takes a callout down, for moderation. It disappears from every list, statistic, leaderboard and competition standing, and a callout.removed event goes out on the stream. There is no webhook for removals. Removing cannot be undone. A removed callout no longer counts for the 24-hour rule or the cooldown, so the user can call again.

Body

string

required

The callout id.

string

Your reason, up to 200 characters. Stored, not shown.

Usage Example

curl -X POST "https://api-id.cabalspy.xyz/v1/callouts/remove" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d", "reason": "Spam"}'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/callouts/remove",
                  json={"id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d", "reason": "Spam"},
                  headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["data"])

const res = await fetch("https://api-id.cabalspy.xyz/v1/callouts/remove", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ id: "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d" }),
});
console.log((await res.json()).data);

Response

string

The callout id.

boolean

Always true.

Response

{
  "success": true,
  "data": { "id": "5b0e7c3a-2d4f-4a6b-9c8d-1e2f3a4b5c6d", "removed": true },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-11-01T19:10:42Z" }
}

Errors

Status	Code	Meaning
400	missing_parameter	id is missing.
400	invalid_parameter	id is not a valid id, or reason is longer than 200 characters.
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 already removed.

See Errors for the full list.

Introduction

Login

Data API

Users

Trading

Theses

Streams

White-Label

Competitions

Callouts

Reference

Make and remove callouts

Make a callout

Body

Usage Example

Response

Errors

Remove a callout

Body

Usage Example

Response

Errors

​Make a callout

​Body

​Usage Example

​Response

​Errors

​Remove a callout

​Body

​Usage Example

​Response

​Errors

Make a callout

Body

Usage Example

Response

Errors

Remove a callout

Body

Usage Example

Response

Errors