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

<ParamField query="blockchain" type="string" required>
  Chain of the token. One of solana, bnb, base, eth, rh.
</ParamField>

<ParamField query="mint" type="string" required>
  Token address: a Solana mint or a 0x contract address.
</ParamField>

<ParamField query="scope" default="global" type="string">
  `global` counts theses of all platforms, `instance` only the theses written on your instance. See [Reach](/cabalspy-id/theses#reach).
</ParamField>

<ParamField query="api_key" type="string" required>
  Your API key. Alternatively pass it as an Authorization Bearer header.
</ParamField>

## Usage Example

<CodeGroup>
  ```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);
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean">
  True on success.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="theses" type="integer">
      Visible theses on the token (replies not counted).
    </ResponseField>

    <ResponseField name="bull" type="integer">
      Theses tagged bull.
    </ResponseField>

    <ResponseField name="bear" type="integer">
      Theses tagged bear.
    </ResponseField>

    <ResponseField name="authors" type="integer">
      Different people who wrote a thesis.
    </ResponseField>

    <ResponseField name="token" type="object">
      chain, mint, name, symbol, logo and price\_usd. Name, logo and price can be null when unknown.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```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"
    }
  }
  ```
</ResponseExample>

## 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 or not enabled for CabalSpy ID. |
| 429 | rate\_limit\_exceeded | Rate limit exceeded. |


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