Get a theme with its members and history
get_themeOne of YOUR themes in full. A theme is a named group of tickers with attribution. kind rule: the user's own words (rule_text), compiled once per save or edit into a ranked list. Tracked tickers (at most tracked_cap, at most 10: a theme never opens more than 10 Gambits) open a follow: each is followed as an ordinary Gambit, so it gets Gambit's take. They are chosen when the theme is saved, edited or activated, in this order: tickers the user added by hand or named in the rule (added_by user), then tickers with the most recent event in the last 7 days (an opportunity card or a news item on it), ties by rank. A member's tracked_by says why it is tracked. The rest, up to watched_cap, are watched: listed with their reason, no Gambit. Tiers do not move between those moments. kind manual: tickers the user adds by hand, tracked up to tracked_cap and watched past it. A Gambit the theme opened becomes the user's own, and no theme stops it, once the user follows that ticker with create_gambit or changes its monitoring. Every member records how it got in (added_by rule, news or user) and why (reason); every change is an event. rule_version counts the compiles of the rule; member_list_version counts the changes of the member list. A draft theme follows nothing; an active one follows its tracked members. Themes never trade. Returns everything list_themes returns, plus members grouped by tier: members.tracked and members.watched, each with subject_id, symbol, added_by (rule | news | user: how it got in), reason (why it is in), tracked_by (for a tracked member, why it is tracked and so followed: named_in_rule, added_by_user, or the card or news event with its id and time), signal (the numbers the compile's ranking saw: r5, r20, r60 returns in percent, volz, dv20_usd_m, cards7, news7, and bars, the price source; a missing number means no data), tradable (true when it has a Hyperliquid listing; without one it can only be watched for trading), case_id (the Gambit this theme opened for a tracked member; null when the user already followed the ticker or it is watched), rank (its place in the latest compile), joined_at and updated_at. events: the last 50 changes, newest first, each with kind (created, compiled, edited, activated, paused, archived, joined, left, promoted, demoted), subject_id and symbol (for a member change), added_by (who caused it: rule, news or user), reason, the rule_version and member_list_version after it, payload (for example what happened to the member's Gambit: opened, resumed, already_followed, stopped or handed_over to another theme) and created_at. Cite a theme as theme_id + rule_version + member_list_version. Errors: 404 theme_not_found (not yours, or no such theme); 503 themes_disabled. (Requires api:read.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"theme_id": "<theme_id>"
},
"name": "get_theme"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| theme_id | Yes | a theme id from list_themes (UUID) |