Query Parameters
Usage Example
Response
Theses, the same object as in List theses.
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 },
"my_reactions": [],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
}
],
"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/user: the theses one user wrote, newest first, by csid_id or X handle.
{
"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 },
"my_reactions": [],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
}
],
"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"
}
}
curl "https://api-id.cabalspy.xyz/v1/theses/user?username=MazeCCC" \
-H "Authorization: Bearer YOUR_KEY"
import requests
r = requests.get("https://api-id.cabalspy.xyz/v1/theses/user", params={"username": "MazeCCC"},
headers={"Authorization": "Bearer YOUR_KEY"})
for t in r.json()["data"]:
print(t["created_at"], t["chain"], t["mint"], t["stance"])
const res = await fetch("https://api-id.cabalspy.xyz/v1/theses/user?username=MazeCCC", {
headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
data.forEach(t => console.log(t.mint, t.stance, t.position.now?.pnl_usd));
{
"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 },
"my_reactions": [],
"via": "Example Terminal",
"created_at": "2026-10-13T09:12:44.512113+00:00",
"is_mine": false,
"position": { "private": true }
}
],
"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 | Neither csid_id nor username was passed. |
| 400 | invalid_parameter | csid_id or limit invalid. |
| 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). |
| 404 | profile_not_found | No CabalSpy ID user with this username. |
| 429 | rate_limit_exceeded | Rate limit exceeded. |
