Trades ====== The Trades view is the heart of FTJ. It's where you create, view, edit, and journal every trade. The view is organized into three columns: a trade list on the left, and the trade detail cards in the center and right panels. .. image:: /_static/card_trades.png :alt: Full Trades view :align: center | Trade List ---------- The left panel shows all your trades in a scrollable list. Each row displays: - **Instrument** (e.g. BTCUSD, NG, GBPUSD) - **Direction** badge (green "Long" or red "Short") - **Date** of the trade - **Net P&L** Sorting ~~~~~~~ Use the dropdown at the top of the list to sort by: - **Newest first** (default) - **Oldest first** - **Instrument A-Z** - **Instrument Z-A** - **Net P/L high → low** - **Net P/L low → high** Searching ~~~~~~~~~ The search bar at the top of the page allows you to filter trades by instrument name. .. TODO: Confirm what the search field filters on (instrument only, or also notes/strategy/etc.) New Trade ~~~~~~~~~ Click the **+ New Trade** button in the trade list header to create a blank trade entry. FTJ pre-fills the first account, sets the direction to Long, and timestamps the entry to now. The cursor moves to the instrument field so you can start typing immediately. Filtering ~~~~~~~~~ Click the **Filters** button (top-right) to open the filter panel. Click the clear button to clear any applied filters and the following filters are as below: .. TODO: Document the available filters - account, date range, direction, strategy, confluence, etc. .. image:: /_static/card_filter.png :alt: Trades filter panel :align: center .. TODO: Replace with a screenshot of the filter panel open. | Trade Lifecycle --------------- Every trade in FTJ follows a five-step lifecycle, visualized by the pipeline bar at the top of the view: .. image:: /_static/card_guide.png :alt: Trade lifecycle bar :align: center .. TODO: Replace with a screenshot of the lifecycle bar. .. TODO: Consider a GIF clicking through each lifecycle step. | Trade Detail Cards ------------------ When you select a trade, the center and right panels display its detail cards. Here's a breakdown of each card: Strategy & Confluences Card ~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /_static/card_strategies.png :alt: Strategy & Confluences card :align: left :height: 220px .. raw:: html
This card lets you tag a trade with one or more **strategies** and **confluences**. - **Strategies** represent your trading setups (e.g. "Breakout Trading", "Mean Reversion"). - **Confluences** represent the market conditions or signals that supported your entry (e.g. "Volume Confirmation", "Support/Resistance Level"). Confluences exist as a global list, but each strategy *can* have a **defined set of linked confluences** configured in the :doc:`strategies` view. This link drives an auto-selection behaviour when tagging trades: - When you **add a strategy** to a trade, all confluences linked to that strategy are **automatically selected** as well. - When you **remove a confluence**, any strategy that depends on it is **automatically removed** from the trade. - You can still independently add or remove any confluence, even ones not linked to the selected strategies, the auto-selection is a convenience, not a restriction. Both **+ Add Strategy** and **+ Add Confluence** open the same picker window, which shows all strategies on the left and all confluences on the right as toggle buttons. Each column has a search bar to quickly filter items. Selections take effect immediately and close the picker when you're done. Selected strategies appear as coloured buttons on the card; selected confluences appear below them. Click the **✕** on any button to remove it. Entry Card ~~~~~~~~~~ The Entry card captures all details about your position entry: - **Instrument** - The traded symbol. - **Direction** - Long or Short toggle. - **Entry Price (Avg/VWAP)** - The price at which you entered (volume-weighted if multiple fills). - **Quantity** - Position size, in units or lots (toggle with the Mode dropdown). - **Session** - The trading session (NY, Morning, Afternoon, etc.). - **Currency** - The instrument's quote currency. - **Account** - The account this trade belongs to. - **Entry Date Time** - Precise entry timestamp with optional milliseconds. - **Timeframe** - The chart timeframe you were trading on. If the trade was imported from executions, a **"Derived from executions"** badge appears and the fields are read-only (computed from individual fills). Exit Card ~~~~~~~~~ The Exit card captures how and why you closed the trade: - **Exit Date Time** - When the position was closed. - **Exit Price (Avg/VWAP)** - Exit price (volume-weighted if multiple fills). - **Stop Loss** - Your planned stop loss level. - **Take Profit** - Your planned take profit. - **R/R Ratio** - Automatically computed risk-reward ratio. - **Gross P/L (Base)** and **Net P/L (Base)** - P&L in account base currency. - **Swap** and **Fees** - Overnight charges and commissions. - **Exit Reason** - Select from your configured exit reasons. Executions Card ~~~~~~~~~~~~~~~ For trades built from individual fills, the Executions card displays a table of all executions. Example: .. list-table:: :widths: 15 10 15 15 15 15 15 :header-rows: 1 * - Time - Side - Qty - Price - Fee - Order ID - Notes * - 16:10:17 - B (Buy) - 5000 - 2.42958 - 13.73 - NG - * - 16:11:56 - B (Buy) - 5000 - 2.42958 - 13.73 - NG - * - 16:33:17 - S (Sell) - 10000 - 2.45587 - 0.00 - NG - Actions available: - **+ Add** - Create a new execution manually. - **Create Entry** - Convert a manual trade to execution-based mode. This creates an execution from the trade's current entry fields (price, quantity, direction, date). Only available when the trade has no executions yet. This action is irreversible - once converted, entry and exit fields become read-only and are derived from executions. - **Edit** - Modify the selected execution (opens a separate editor window). - **Reload** - Re-fetch from the database. - **Delete** - Remove the selected execution. - **Close Position** - Add a closing fill to flatten the position. Lock / Unlock ^^^^^^^^^^^^^ When an execution-based trade is closed (net position is flat), its executions are automatically **locked** to prevent accidental edits. Manual trades are not affected by locking. A blue **Locked** indicator appears in the executions toolbar. To make corrections, click the lock icon to temporarily unlock the trade. A yellow **Unlocked** indicator confirms that execution editing is enabled. Click the lock icon again to re-lock. The unlock is temporary - selecting a different trade or performing an execution operation automatically re-locks the trade. The **Linked group** indicator at the bottom shows whether the position is **CLOSED** (flat) or still open. Images Card ~~~~~~~~~~~ Attach chart screenshots or other visual references to a trade: - Drag and drop images onto the card. - Click the **+** button to browse for files. - Click a thumbnail to view it full-size. - Click the **✕** to remove an image. - Images are stored within the database (no external file links to break). - Maximum dimensions and file size are configurable in Settings (default: 1920×1080, 2 MB). .. tip:: If you add an image that exceeds the configured maximum dimensions, FTJ offers to resize it automatically. You can change the max dimensions in Settings. FTJ can also automatically convert images to JPEG to save database space. **"Prefer JPEG for screenshots"** is enabled in Settings by default. Journal Notes Card ~~~~~~~~~~~~~~~~~~ Two text fields for free-form writing: - **Trade Notes** - Your post-trade analysis and observations. - **Pre-Trade Plan** - What was your plan before entering? Document it here and compare with what actually happened. Self-Reflection Card ~~~~~~~~~~~~~~~~~~~~ Rate your trade across five dimensions using visual emoji scales (1–5): 1. **Did I follow my trading plan?** (checkmarks) 2. **Did I react well to market conditions?** (chart icons) 3. **Positive gut feeling at entry?** (compass icons) 4. **Satisfied with exit timing?** (flag icons) 5. **Overall trade rating** (stars) An **Additional Reflection** text area is available for longer-form notes. Navigation ---------- At the bottom of the Trades view: - **← Prev** / **→ Next** - Navigate between trades sequentially. - **Refresh** - Reload the current trade from the database. - **Delete** - Permanently remove the current trade (confirmation required). - **Cancel** - Discard all changes and return to the previous state. - **Save Changes** - Saves all edits to the database. .. warning:: The **Delete** action is permanent and cannot be undone. Make sure you have a backup of your database if you're deleting trades.