React

{
  "success": true,
  "data": {
    "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "reactions": { "like": 5, "🚀": 2 }
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:30:00Z" }
}

{
  "success": true,
  "data": {
    "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "reactions": { "like": 5, "🚀": 2 }
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:30:00Z" }
}

Adds or removes a reaction on a thesis or reply in the name of one of your users. A like also counts towards the post’s likes, which sort=top uses. A thesis.reaction event with the new counts goes out on the stream. Reactions: like, 🔥, 🚀, 💎, 👀, 😂, 🤝, 💀, 🐂, 🐻. Each user can add each reaction once per post.

Body

string

required

The thesis or reply.

string

required

like or one of the emoji above.

boolean

default:"true"

true adds the reaction, false removes it.

string

required

The user, 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/reactions" \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"thesis_id":"8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60","emoji":"like","on":true,"csid_id":"5e2d8c41-7a9b-4c3e-b1f0-6d5e4c3b2a19"}'

import requests

r = requests.post("https://api-id.cabalspy.xyz/v1/theses/reactions",
                  headers={"Authorization": "Bearer YOUR_KEY"},
                  json={"thesis_id": thesis_id, "emoji": "🚀", "on": True, "csid_id": session_user_sub})
print(r.json()["data"]["reactions"])

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

Response

boolean

True on success.

object

Show data

string

The post.

object

The new count per reaction.

{
  "success": true,
  "data": {
    "id": "8d1f5a2e-6c4b-4e0f-9a7d-1b2c3d4e5f60",
    "reactions": { "like": 5, "🚀": 2 }
  },
  "meta": { "request_id": "req_5162c7cf7f87", "cached": false, "cache_age_seconds": 0, "version": "v1", "timestamp": "2026-10-13T09:30:00Z" }
}

Errors

Status	Code	Meaning
400	missing_parameter	thesis_id, emoji or csid_id is missing.
400	invalid_parameter	Unknown reaction or invalid csid_id.
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 and reacting.
404	not_found	The post does not exist, was hidden or deleted.
429	rate_limited	The user reacts too fast: 120 reactions 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