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": 1,
"replies": 1,
"reactions": { "like": 1 },
"my_reactions": ["like"],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "v1",
"timestamp": "2026-10-13T10:04:11Z"
}
}
GET /v1/theses/item: one thesis or reply by id, with author, reactions and the author’s 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": 1,
"replies": 1,
"reactions": { "like": 1 },
"my_reactions": ["like"],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "v1",
"timestamp": "2026-10-13T10:04:11Z"
}
}
not_found.
curl "https://api-id.cabalspy.xyz/v1/theses/item?id=8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60" \
-H "Authorization: Bearer YOUR_KEY"
import requests
r = requests.get("https://api-id.cabalspy.xyz/v1/theses/item",
params={"id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60", "csid_id": viewer_sub},
headers={"Authorization": "Bearer YOUR_KEY"})
t = r.json()["data"]
print(t["body"], t["replies"], t["my_reactions"])
const p = new URLSearchParams({ id: "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/theses/item?${p}`, {
headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
console.log(data.body, data.likes);
reply, a parent_id and no 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": 1,
"replies": 1,
"reactions": { "like": 1 },
"my_reactions": ["like"],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
},
"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 | id is missing. |
| 401 | missing_api_key | API key missing. |
| 403 | invalid_api_key | API key invalid or not enabled for CabalSpy ID. |
| 404 | not_found | No such post, or it was hidden or deleted. |
| 429 | rate_limit_exceeded | Rate limit exceeded. |