Create, edit, activate, pause or archive a theme
save_themeCreate, edit, activate, pause or archive one of YOUR themes (requires api:account). 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. Pick the action. create: kind rule with name and rule_text (one compile, which counts against the limit of 10 compiles per user per UTC day (preview, a rule create, and an edit with rule_text each count); the tracked and watched members are saved with their reasons), or kind manual with name and symbols (up to 25 tickers; the first tracked_cap are tracked, the rest watched; no compile). status draft (the default; follows nothing) or active. tracked_cap (1-10, default 10: a theme never opens more than 10 Gambits) and watched_cap (0-90, default 90) are optional. edit (theme_id): name, tracked_cap, watched_cap, or rule_text, which compiles again (even the same text: a converted saved Gambit starts as a draft that was never compiled; edit it with its rule_text to compile it) and writes a new rule_version and member list. activate (theme_id): sets the tracked tickers again from the last 7 days' events, then follows each tracked member as a Gambit (a ticker the user already follows keeps its own Gambit and the theme links nothing); a rule theme must be compiled first. pause (theme_id): stops the Gambits this theme opened, unless another active theme tracks the same ticker; the user's own Gambits are never stopped (a Gambit the theme opened becomes the user's own once the user follows the ticker with create_gambit or changes its monitoring). archive (theme_id): the same, and the theme can no longer change. Confirm with the user before pausing or archiving. Returns the theme as get_theme does (plus changed for a status action). A user keeps at most 5 themes that are not archived (a server setting); over it the call answers 403 theme_limit_exceeded. Other errors: 404 theme_not_found; 409 invalid_transition, theme_not_compiled, theme_archived, tracked_cap_below_members; 422 unknown_symbol or ambiguous_symbol (with symbols), theme_compile_empty, caps_too_large; 429 theme_compile_limit; 502 theme_compile_failed; 503 themes_disabled. Nothing here places a trade.
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": {
"action": "<action>"
},
"name": "save_theme"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | REQUIRED for create | |
| name | No | REQUIRED for create | |
| action | Yes | ||
| status | No | create only: draft (default) or active | |
| symbols | No | create (kind manual): tickers such as MU or xyz:MU | |
| theme_id | No | REQUIRED for edit, activate, pause and archive | |
| rule_text | No | create (kind rule) or edit: the user's own words; compiles | |
| tracked_cap | No | ||
| watched_cap | No |