Query Parameters
global for theses of all platforms, instance for only the theses written on your instance. See Reach.Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
{
"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"
}
}
GET /v1/theses: the theses of a token, newest or top first, each with the author’s real position and PnL.
{
"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"
}
}
global for theses of all platforms, instance for only the theses written on your instance. See Reach.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));
Show thesis
{"private": true} when the author keeps their trading private.Show position
{
"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"
}
}
| 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. |
| 403 | product_not_enabled | The key is not enabled for the CabalSpy ID API (API keys page, Works with). |
| 429 | rate_limit_exceeded | Rate limit exceeded. |
