Query Parameters
global counts theses of all platforms, instance 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": {
"theses": 12,
"bull": 9,
"bear": 2,
"authors": 10,
"token": {
"chain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"name": "invisibull",
"symbol": "invisibull",
"logo": "https://...",
"price_usd": 0.0463
}
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "v1",
"timestamp": "2026-10-13T10:04:11Z"
}
}
GET /v1/theses/summary: number of theses, bull and bear counts and authors for a token, with token name, symbol, logo and price.
{
"success": true,
"data": {
"theses": 12,
"bull": 9,
"bear": 2,
"authors": 10,
"token": {
"chain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"name": "invisibull",
"symbol": "invisibull",
"logo": "https://...",
"price_usd": 0.0463
}
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "v1",
"timestamp": "2026-10-13T10:04:11Z"
}
}
global counts theses of all platforms, instance only the theses written on your instance. See Reach.curl "https://api-id.cabalspy.xyz/v1/theses/summary?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump" \
-H "Authorization: Bearer YOUR_KEY"
import requests
r = requests.get("https://api-id.cabalspy.xyz/v1/theses/summary",
params={"blockchain": "solana", "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump"},
headers={"Authorization": "Bearer YOUR_KEY"})
s = r.json()["data"]
print(s["token"]["symbol"], s["theses"], "theses,", s["bull"], "bull /", s["bear"], "bear")
const p = new URLSearchParams({ blockchain: "solana", mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/theses/summary?${p}`, {
headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
console.log(data.token.symbol, data.bull, data.bear);
{
"success": true,
"data": {
"theses": 12,
"bull": 9,
"bear": 2,
"authors": 10,
"token": {
"chain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"name": "invisibull",
"symbol": "invisibull",
"logo": "https://...",
"price_usd": 0.0463
}
},
"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 or scope. |
| 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. |
