Post reply

{
  "success": true,
  "data": {
    "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
    "chain": "solana",
    "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    "kind": "reply",
    "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "body": "Nice call",
    "stance": null,
    "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
    "likes": 0,
    "replies": 0,
    "reactions": {},
    "my_reactions": [],
    "via": "Example Terminal",
    "created_at": "2026-10-13T09:20:02.118004+00:00",
    "is_mine": false
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:20:02Z" }
}

{
  "success": true,
  "data": {
    "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
    "chain": "solana",
    "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    "kind": "reply",
    "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "body": "Nice call",
    "stance": null,
    "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
    "likes": 0,
    "replies": 0,
    "reactions": {},
    "my_reactions": [],
    "via": "Example Terminal",
    "created_at": "2026-10-13T09:20:02.118004+00:00",
    "is_mine": false
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:20:02Z" }
}

Replies to a thesis in the name of one of your users. Any of your users who granted the scope thesis can reply, holding the token is not required. Replies are one level deep: you reply to a thesis, not to a reply. A thesis.reply event goes out on the stream.

Body

string

required

The thesis to reply to.

string

required

The reply, up to 1,000 characters, same text rules as theses.

string

required

The author, one of your users.

string

required

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

Usage Example

curl -X POST "https://api-id.cabalspy.xyz/v1/theses/replies" \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"thesis_id":"8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60","body":"Nice call","csid_id":"5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19"}'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/theses/replies",
                  headers={"Authorization": "Bearer YOUR_KEY"},
                  json={"thesis_id": thesis_id, "body": text, "csid_id": session_user_sub})
reply = r.json()["data"]

const res = await fetch("https://api-id.cabalspy.xyz/v1/theses/replies", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ thesis_id: thesisId, body: text, csid_id: session.userSub }),
});
const { data } = await res.json();

Response

boolean

True on success. The status is 201.

object

The new reply, the same object as in List replies.

{
  "success": true,
  "data": {
    "id": "2a9c7e10-4b3d-4f5e-8a6b-7c8d9e0f1a2b",
    "chain": "solana",
    "mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    "kind": "reply",
    "parent_id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "body": "Nice call",
    "stance": null,
    "author": { "csid_id": "5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19", "username": "degen_dan", "name": "Dan", "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg", "kol_badge": false, "profile_url": "https://id.cabalspy.xyz/u/degen_dan" },
    "likes": 0,
    "replies": 0,
    "reactions": {},
    "my_reactions": [],
    "via": "Example Terminal",
    "created_at": "2026-10-13T09:20:02.118004+00:00",
    "is_mine": false
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:20:02Z" }
}

Errors

Status	Code	Meaning
400	missing_parameter	thesis_id, body or csid_id is missing.
400	invalid_parameter	csid_id invalid.
400	invalid_body	Text empty, too long, too many links, all caps, spam or a blocked word.
400	duplicate	The user posted the same text within the last day.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	consent_required	The user has not granted your app the scope thesis.
403	plan_user_limit	The user is beyond your plan’s user limit.
403	sandbox_user	Sandbox test users cannot write.
403	posting_paused	The user is paused from writing.
404	not_found	The thesis does not exist, was hidden or deleted, or is itself a reply.
429	rate_limited	The user replies too fast: 30 replies per hour.
429	rate_limit_exceeded	Your API key’s request rate is exceeded.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Body

Usage Example

Response

Errors

​Body

​Usage Example

​Response

​Errors

Body

Usage Example

Response

Errors