> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabalspy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Thesis summary

> GET /v1/theses/summary: number of theses, bull and bear counts and authors for a token, with token name, symbol, logo and price.

Counts for a token's theses, how many there are, how many are bullish or bearish and how many people wrote them, plus the token's name, symbol, logo and USD price. Use it for a header above the thesis list or a sentiment badge next to a token.

## Query Parameters

**blockchain** `string` *required*

Chain of the token. One of solana, bnb, base, eth, rh.

**mint** `string` *required*

Token address: a Solana mint or a 0x contract address.

**scope** `string` (default: global)

`global` counts theses of all platforms, `instance` only the theses written on your instance. See [Reach](https://docs.cabalspy.xyz/cabalspy-id/theses.md#reach).

**api\_key** `string` *required*

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

## Usage Example

```bash cURL theme={null}
curl "https://api-id.cabalspy.xyz/v1/theses/summary?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump" \
  -H "Authorization: Bearer YOUR_KEY"
```

```python Python theme={null}
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")
```

```javascript JavaScript theme={null}
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);
```

## Response

**success** `boolean`

True on success.

**data** `object`

**data**

**theses** `integer`

Visible theses on the token (replies not counted).

**bull** `integer`

Theses tagged bull.

**bear** `integer`

Theses tagged bear.

**authors** `integer`

Different people who wrote a thesis.

**token** `object`

chain, mint, name, symbol, logo and price\_usd. Name, logo and price can be null when unknown.

```json Response theme={null}
{
  "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"
  }
}
```

## Errors

| 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.