Eligibility

{
  "success": true,
  "data": { "can_post": true, "can_reply": true, "holder": true, "paused": false },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T10:04:11Z" }
}

{
  "success": true,
  "data": { "can_post": false, "can_reply": false, "holder": null, "paused": false, "reason": "consent_required" },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T10:04:11Z" }
}

{
  "success": true,
  "data": { "can_post": true, "can_reply": true, "holder": true, "paused": false },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T10:04:11Z" }
}

{
  "success": true,
  "data": { "can_post": false, "can_reply": false, "holder": null, "paused": false, "reason": "consent_required" },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T10:04:11Z" }
}

Whether one of your users can post a thesis on a token and whether they can reply. Call it before you show a Post thesis button: only holders can post, and users who did not grant the scope thesis, are beyond your plan’s user limit or are paused cannot write.

Query Parameters

string

required

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

string

required

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

string

required

The user, the sub of their ID token.

string

Your Instance ID. Only needed when your account has several instances.

string

required

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

Usage Example

curl "https://api-id.cabalspy.xyz/v1/theses/eligibility?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&csid_id=0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

r = requests.get("https://api-id.cabalspy.xyz/v1/theses/eligibility",
                 params={"blockchain": "solana", "mint": mint, "csid_id": user_sub},
                 headers={"Authorization": "Bearer YOUR_KEY"})
e = r.json()["data"]
show_post_button = e["can_post"]
show_reply_box = e["can_reply"]

const p = new URLSearchParams({ blockchain: "solana", mint, csid_id: userSub });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/theses/eligibility?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
if (!data.can_post && data.reason === "consent_required") askForThesisScope();

Response

boolean

True on success.

object

Show data

boolean

The user can post a thesis on this token now.

boolean

The user can reply and react (false while paused).

boolean

One of the user’s verified wallets holds the token. Null when the user cannot write through your app at all.

boolean

The user is paused from writing by moderation.

string

Only when the user cannot write through your app: consent_required (no scope thesis), plan_user_limit or sandbox_user.

{
  "success": true,
  "data": { "can_post": true, "can_reply": true, "holder": true, "paused": false },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T10:04:11Z" }
}

{
  "success": true,
  "data": { "can_post": false, "can_reply": false, "holder": null, "paused": false, "reason": "consent_required" },
  "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, mint or csid_id is missing.
400	invalid_parameter	Unknown chain, invalid token address or csid_id.
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.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors