List theses

{
  "success": true,
  "data": [
    {
      "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "kind": "thesis",
      "parent_id": null,
      "body": "Strong community, dev still holding, chart just broke out. Still early.",
      "stance": "bull",
      "author": {
        "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
        "username": "MazeCCC",
        "name": "Maze",
        "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
        "kol_badge": true,
        "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
      },
      "likes": 4,
      "replies": 1,
      "reactions": { "like": 4, "🚀": 2 },
      "reacted_by": [
        { "emoji": "🚀", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:31:10.204511+00:00" },
        { "emoji": "like", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:30:58.917203+00:00" }
      ],
      "my_reactions": [],
      "via": "Example Terminal",
      "created_at": "2026-10-13T09:12:44.512113+00:00",
      "is_mine": false,
      "latest_replies": [
        {
          "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "kind": "reply",
          "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
          "body": "Nice call",
          "stance": null,
          "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
          "likes": 0,
          "replies": 0,
          "reactions": {},
          "reacted_by": [],
          "my_reactions": [],
          "via": "Example Terminal",
          "created_at": "2026-10-13T09:20:02.118004+00:00",
          "is_mine": false
        }
      ],
      "position": {
        "at_post": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": null,
          "pnl_usd": null,
          "pnl_percent": null,
          "tokens_held": 5000.0,
          "first_buy": "2026-10-13T08:12:40+00:00"
        },
        "now": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": 231.5,
          "pnl_usd": 81.5,
          "pnl_percent": 54.33,
          "tokens_held": 5000.0,
          "status": "holding"
        }
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "total": null,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T10:04:11Z"
  }
}

{
  "success": true,
  "data": [
    {
      "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "kind": "thesis",
      "parent_id": null,
      "body": "Strong community, dev still holding, chart just broke out. Still early.",
      "stance": "bull",
      "author": {
        "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
        "username": "MazeCCC",
        "name": "Maze",
        "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
        "kol_badge": true,
        "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
      },
      "likes": 4,
      "replies": 1,
      "reactions": { "like": 4, "🚀": 2 },
      "reacted_by": [
        { "emoji": "🚀", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:31:10.204511+00:00" },
        { "emoji": "like", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:30:58.917203+00:00" }
      ],
      "my_reactions": [],
      "via": "Example Terminal",
      "created_at": "2026-10-13T09:12:44.512113+00:00",
      "is_mine": false,
      "latest_replies": [
        {
          "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "kind": "reply",
          "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
          "body": "Nice call",
          "stance": null,
          "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
          "likes": 0,
          "replies": 0,
          "reactions": {},
          "reacted_by": [],
          "my_reactions": [],
          "via": "Example Terminal",
          "created_at": "2026-10-13T09:20:02.118004+00:00",
          "is_mine": false
        }
      ],
      "position": {
        "at_post": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": null,
          "pnl_usd": null,
          "pnl_percent": null,
          "tokens_held": 5000.0,
          "first_buy": "2026-10-13T08:12:40+00:00"
        },
        "now": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": 231.5,
          "pnl_usd": 81.5,
          "pnl_percent": 54.33,
          "tokens_held": 5000.0,
          "status": "holding"
        }
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "total": null,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T10:04:11Z"
  }
}

The theses of one token, newest first or by likes, optionally only bullish or bearish ones. Every thesis carries its author, reaction counts, the app it was posted from and the author’s real position in the token. Theses are public: any API key can read them, for any token, including theses posted on other platforms.

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

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

default:"new"

new (newest first) or top (most likes first).

string

Only bull or only bear theses. Empty means all.

integer

default:"20"

Theses per page, 1 to 50.

string

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

string

The viewer, one of your users. Fills my_reactions and is_mine.

string

default:"global"

global for theses of all platforms, instance for only the theses written on your instance. See Reach.

string

required

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

Usage Example

curl "https://api-id.cabalspy.xyz/v1/theses?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&sort=top" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

params = {"blockchain": "solana", "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", "sort": "top"}
r = requests.get("https://api-id.cabalspy.xyz/v1/theses", params=params,
                 headers={"Authorization": "Bearer YOUR_KEY"})
for t in r.json()["data"]:
    pos = t["position"].get("now") or {}
    print(t["author"]["username"], t["stance"], t["likes"], pos.get("pnl_usd"), t["body"][:60])

const p = new URLSearchParams({
  blockchain: "solana",
  mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
  sort: "top",
});
const res = await fetch(`https://api-id.cabalspy.xyz/v1/theses?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
data.forEach(t => console.log(t.author.username, t.stance, t.position.now?.pnl_usd));

Response

boolean

True on success.

array

Show thesis

string

Thesis id.

string

Chain of the token.

string

Token address (EVM addresses in lower case).

string

thesis or reply.

string

For replies, the thesis replied to. Null for theses.

string

The text, up to 1,000 characters. Plain text, escape it when you render.

string

bull, bear or null.

object

Show author

string

The author’s CabalSpy ID.

string

X handle.

string

Display name.

string

Avatar URL.

boolean

Whether the author holds the KOL badge.

string

Public CabalSpy ID profile.

integer

Number of likes.

integer

Number of replies.

object

Count per reaction, for example {"like": 4, "🚀": 2}.

array

Who reacted, newest first, up to 20 entries.

Show reaction

string

like or the emoji.

string

The reacting user’s CabalSpy ID.

string

Their X handle.

string

ISO timestamp of the reaction.

array

The viewer’s own reactions. Empty without csid_id.

boolean

Whether the viewer wrote it.

string

Name of the app it was posted from, or null when posted on CabalSpy ID itself.

string

ISO timestamp.

array

Theses only. The 3 newest replies, oldest of them first, as full reply objects. Load all replies with List replies.

object

Theses only, not on replies. The author’s position in the token. {"private": true} when the author keeps their trading private.

Show position

object

The position when the thesis was posted: invested_usd, realized_usd, holding_value_usd (null), pnl_usd (null while holding), pnl_percent, tokens_held and first_buy (ISO timestamp of the first buy).

object

The live position: invested_usd, realized_usd, holding_value_usd at the current price, pnl_usd and pnl_percent (realized plus holding value minus invested), tokens_held and status (holding or sold). Values that need a price are null when no price is available.

object

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

{
  "success": true,
  "data": [
    {
      "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
      "chain": "solana",
      "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
      "kind": "thesis",
      "parent_id": null,
      "body": "Strong community, dev still holding, chart just broke out. Still early.",
      "stance": "bull",
      "author": {
        "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
        "username": "MazeCCC",
        "name": "Maze",
        "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
        "kol_badge": true,
        "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
      },
      "likes": 4,
      "replies": 1,
      "reactions": { "like": 4, "🚀": 2 },
      "reacted_by": [
        { "emoji": "🚀", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:31:10.204511+00:00" },
        { "emoji": "like", "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "at": "2026-10-13T09:30:58.917203+00:00" }
      ],
      "my_reactions": [],
      "via": "Example Terminal",
      "created_at": "2026-10-13T09:12:44.512113+00:00",
      "is_mine": false,
      "latest_replies": [
        {
          "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
          "chain": "solana",
          "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "kind": "reply",
          "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
          "body": "Nice call",
          "stance": null,
          "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
          "likes": 0,
          "replies": 0,
          "reactions": {},
          "reacted_by": [],
          "my_reactions": [],
          "via": "Example Terminal",
          "created_at": "2026-10-13T09:20:02.118004+00:00",
          "is_mine": false
        }
      ],
      "position": {
        "at_post": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": null,
          "pnl_usd": null,
          "pnl_percent": null,
          "tokens_held": 5000.0,
          "first_buy": "2026-10-13T08:12:40+00:00"
        },
        "now": {
          "invested_usd": 150.0,
          "realized_usd": 0.0,
          "holding_value_usd": 231.5,
          "pnl_usd": 81.5,
          "pnl_percent": 54.33,
          "tokens_held": 5000.0,
          "status": "holding"
        }
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "total": null,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T10:04:11Z"
  }
}

Errors

Status	Code	Meaning
400	missing_parameter	blockchain or mint is missing.
400	invalid_parameter	Unknown chain, invalid token address, sort, stance, scope or limit.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
429	rate_limit_exceeded	Rate limit exceeded.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors