Recovery
The Recovery tab shows trades that need your attention — usually because something went wrong during order execution.
When Does a Trade Need Recovery?
Trades end up in the Recovery panel when:
- An order timed out — it was submitted but never filled or confirmed within the expected timeframe
- An order was rejected by the broker
- An order was canceled or expired before filling
- The status is unknown — the bot lost connection before confirming the result
What You See
Each trade needing recovery shows:
- Symbol — What option or spread was being traded
- Status — The current state: Pending (⏳), Rejected (❌), Canceled, Expired, or Timeout (⚠️)
- Strategy — Which strategy initiated the trade
- Timestamp — When the issue occurred
Status Meanings
| Status | Icon | What Happened |
|---|---|---|
| Pending | ⏳ (amber) | Order is still in limbo — hasn’t been confirmed |
| Filled | ✅ (green) | Actually filled — just needs reconciliation |
| Rejected | ❌ (red) | Broker refused the order (e.g., insufficient buying power) |
| Canceled | ❌ (gray) | Order was canceled before filling |
| Expired | ❌ (gray) | Order expired without filling |
| Timeout Unknown | ⚠️ (amber) | Bot doesn’t know what happened — check your broker |
Resolving a Trade
For timed-out or unknown trades, you have options:
Resolve as Filled
If you check your broker and see the order actually filled:
- Click Resolve on the trade
- Enter the fill price and quantity
- Confirm — this updates the trade journal with the actual fill data
Mark as Not Filled
If the order never executed:
- Click the appropriate action to mark it as rejected or canceled
- The trade is removed from the recovery queue
Delete
If the trade is a duplicate or error, you can remove it entirely.
Why Does This Matter?
Unrecovered trades can cause problems:
- P&L might be inaccurate — If a trade filled but wasn’t recorded, your P&L is wrong
- Position count is off — The bot might think it has fewer (or more) positions than reality
- Duplicate trades — If the bot doesn’t know a trade filled, it might try to open another one
⚠️ Check the Recovery tab whenever you see a disconnect event or if the status ribbon showed “API: DISCONNECTED” during the trading day.
Preventing Recovery Issues
Recovery issues are rare, but they can happen during:
- Internet connectivity problems
- Broker API outages
- Server restarts during market hours
The bot automatically polls for recovery trades every 30 seconds, so the list updates on its own.
💡 Tip: If the Recovery tab consistently has entries, it might indicate a connectivity issue that needs attention. A healthy system should have an empty Recovery tab most of the time.