Commit Window — SOAP2 Help

# Commit Window (Order Preparation) The **Commit** window is where you review a model/position, choose a price, and create an order that is sent to **Interactive Brokers TWS**. It is designed to support a *review-first* workflow. **Related:** - [SOAP2 Help Guide](./index.md.html) - [OptionsChain (OA Window) Guide](./optionschain_overview.md.html) - [Keyboard shortcuts](./keyboard_shortcuts.md.html) --- ## Table of Contents - [When to use Commit](#when-to-use-commit) - [What Commit shows](#what-commit-shows) - [Price controls (mid, lock, ticks)](#price-controls-mid-lock-ticks) - [Sensitivity: IV / Underlying fill likelihood](#sensitivity-iv--underlying-fill-likelihood) - [Order settings](#order-settings) - [Send, edit, and margin impact](#send-edit-and-margin-impact) - [Convert model legs to recorded positions](#convert-model-legs-to-recorded-positions) - [Safety notes](#safety-notes) - [Common issues](#common-issues) --- ## When to use Commit Use Commit when you want to: - turn **model legs** (in an OA) into a **combo order** or single-leg order - review the combo structure and leg details before sending - set order parameters (e.g., order type, TIF, routing) before sending to TWS - review and adjust the working price using live quotes and tick adjustments - request **margin impact** (What-If) before placing an order - optionally **convert** selected model legs into **recorded trade positions** (Trade Log) - place a new order based on a model, or - edit an existing order by loading it into Commit, adjusting parameters, and re-submitting --- ## What Commit shows Commit has two grids: - **Combo grid**: option legs that make up a combo (or a single option leg) - **Underlying grid**: used when placing an underlying-only order Each leg row typically includes: - **ConId / ReqId** (internal identifiers) - bid / ask / mid - strike / right (Call/Put) - quantity (and the leg’s buy/sell direction) - expiry and trading class The **Combo note** area summarizes the legs and displays the current working price. --- ## Price controls (mid, lock, ticks) Commit maintains a live **aggregate mid** based on the legs’ quotes. - When **unlocked**, Commit follows the live mid and updates the working price automatically. - When **locked**, you can set a working **limit price** by moving the tick slider or typing a price. Key controls: - **Lock/Unlock**: freezes the price baseline so you can work a limit around it - **Tick slider**: adjusts the price by a number of **minimum ticks** from the baseline - **Price box**: always rounds to the instrument’s minimum tick Tip: If you are locked and your entered price goes outside the current tick slider range, the slider window recenters automatically. --- ## Sensitivity: IV / Underlying fill likelihood A market maker knows the mark price of your combo and its legs. Getting a limit order filled generally requires the underlying and/or the implied volatility to move a bit in your favor first. The **Sensitivity** tool (toolstrip dropdown, next to Executions) shows this as a 3D surface: it plots your combo's **theoretical price minus your entered Limit price**, across a range of Underlying and IV moves, so you can see at a glance how far the market needs to move for your order to become marketable. Opening the **Sensitivity** dropdown gives you: - **Und x**: the underlying axis step size, in multiples of the underlying's minimum tick (default 1000 — a single minTick is too fine a move to be useful on most underlyings). - **IV +/-%**: the total IV range plotted, in percent (default 0.5, i.e. +/-0.50%). - **Calc/Draw**: computes the surface with the current settings and shows it (replacing the message log area). - **Hide**: hides the surface again and shows the message log. - **Reset Zoom**: clears any scroll-wheel zoom back to the default range. Reading the surface: - The **black crosshair** marks "no move" — today's actual underlying price and IV, with zero assumed change. - The **green line** is the fill boundary: the exact combination of underlying/IV moves where your Theo price equals your Limit price. Blue areas mean the order is closer to marketable; red areas mean it's further away. - **Click anywhere on the surface** for a tooltip showing the exact Theo and Limit values at that point, and whether the order looks **LIKELY** or **UNLIKELY** to fill there, given your order's Buy/Sell direction. - **Drag** to rotate the view; your last rotation is kept when the surface refreshes. - **Scroll the mouse wheel** over the surface to zoom in/out (narrows or widens both axis ranges around the current center); use **Reset Zoom** to return to the default. The surface refreshes automatically every second while it is visible, using the same live quotes as the Combo grid. --- ## Order settings Common settings in Commit: - **Buy/Sell** (combo-level action) - **Order type** (e.g., LMT; some types require a trigger/aux price) - **TIF** (time-in-force) - **Routing** (e.g., SMART; advanced routing list) - **Outside RTH** (if enabled) Quantity: - Commit shows a **canonical combo quantity** and a **multiplier**. - Increasing the multiplier scales the combo size while keeping leg ratios consistent. --- ## Send, edit, and margin impact In the toolstrip (and/or buttons), you can: - **Send order**: places the order in TWS using the currently-entered price - **Edit order**: re-submits the selected order id using the updated parameters - **Margin impact (What-If)**: sends a What-If request so IB returns margin deltas After sending, the order id is also tracked in the Orders window. --- ## Convert model legs to recorded positions Commit can convert selected model legs into **recorded trade positions** by writing them into the Trade Log. Typical use: - you built a model trade - you want to record those legs as a position (for tracking and risk graph) What happens during conversion: - selected legs are written as Trade Exec Records - the trade is saved under the current account - the OA refreshes and positions appear on the chain Notes: - conversion is blocked for expired contracts - conversion uses the current working price / mid as the basis for recorded costs --- ## Safety notes - **Auto Transmit** is powerful. When enabled, orders may transmit immediately at the working price. - Always review what appears in **TWS** before transmitting. - Some fields are marked experimental (e.g., certain routing tags/guarantee settings). --- ## Common issues - **Price stays at 0 / order blocked**: you must enter a non-zero price before placing/editing. - **Blank quotes for some legs**: data subscriptions may still be loading; wait, or reduce the number of visible legs/requests. - **Both underlying and options legs present**: Commit places combo orders and underlying orders separately. --- Go back to the main help page: [SOAP2 Help Guide](./index.md.html)