Annotate a journal trade
journal_update_tradeDestructiveIdempotent
Annotate a trade — the user-owned fields only: notes (free text about this trade), tags, mistakes, playbookId, rating 1–5, stopLoss and profitTarget (price levels; the stop is what realized R is measured against) and reviewed. tags/mistakes replace the whole list; use addTags/removeTags/addMistakes/removeMistakes to change a few entries without clobbering the rest (check journal_list_tags for the user's existing words). Pass null to clear a field. Does not touch fills, prices or P&L — those derive from the fills. Returns the updated trade in full. Requires signing in with a LuxAlgo account (OAuth).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | The trade's `key` exactly as returned by journal_list_trades, journal_get_day, journal_search_notes or journal_add_trade. Never construct one. | |
| tags | No | ||
| notes | No | Replaces the trade's note text; null clears it. | |
| rating | No | Execution quality 1–5; null clears it. | |
| addTags | No | Tags to add (existing ones are kept; case-insensitive duplicates are ignored). | |
| context | Yes | Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution." | |
| mistakes | No | ||
| reviewed | No | Mark the trade reviewed (true) or not (false). | |
| stopLoss | No | Planned stop price; null clears it. | |
| playbookId | No | Playbook / setup name this trade followed; null clears it. | |
| removeTags | No | Tags to remove (case-insensitive). | |
| addMistakes | No | Mistakes to add. | |
| profitTarget | No | Planned target price; null clears it. | |
| removeMistakes | No | Mistakes to remove (case-insensitive). |