smart-oco - Position-Aware OCO Monitoring
Advanced OCO monitoring with automatic order cancellation when position closes or flips direction.
smart-oco is an intelligent version of OCO that tracks position state to decide when to clean up existing orders. It prevents orphaned orders when your position closes or flips direction.
What is smart-oco?
smart-oco is a position-aware version of the oco command. It monitors your existing orders against your position state. When your position goes to zero or flips direction (long to short or vice versa), it automatically cancels the monitored orders.
Key Features:
Auto-cancel on position close: When your position goes to zero, all monitored orders are cancelled
Auto-cancel on position flip: When position switches from long to short (or vice versa), incompatible orders are cancelled
Background monitoring: Runs continuously in the background, checking the position and cancelling tracked orders when a condition is met
smart-oco vs oco: Key Differences
Understanding the difference between oco and smart-oco is crucial for choosing the right tool:
| Feature | oco | smart-oco |
|---|---|---|
| Monitors Orders | Yes | Yes |
| Monitors Position | No | Yes |
| Cancels on Order Fill | Primary orders | No; position conditions only |
| Cancels on Position Close | No | Yes (configurable) |
| Cancels on Position Flip | No | Yes (configurable) |
| Complexity | Simple | Advanced |
When to Use Each
oco: When you only care about order fills (traditional OCO logic)
smart-oco: When you want protection against orphaned orders after position changes (recommended for hedge mode disabled)
How It Works
smart-oco runs a background process that continuously monitors:
1. Order Status Changes
Individual fills or cancellations do not trigger Smart OCO. Partial exits can leave the remaining ladder active while the monitored position stays open on the same side.
2. Position Size Changes (cancelOnZero)
When cancelOnZero=true (default), the system watches your position size:
- If position goes to 0, all monitored orders are cancelled
- Prevents orphaned TP/SL orders after manual position close
- Useful when closing positions via TradingView or exchange UI
3. Position Direction Changes (cancelOnFlip)
When cancelOnFlip=true (default), the system detects direction flips:
- Long position switches to short: cancels all buy orders
- Short position switches to long: cancels all sell orders
- Critical for exchanges without hedge mode enabled
- Prevents accidental order execution in wrong direction
The background monitoring process runs continuously until all orders are filled/cancelled or the monitoring is explicitly stopped.
Syntax
Both syntaxes are supported:
smart-oco [<which>] [cancelOnZero=<bool>] [cancelOnFlip=<bool>]
oco smart [<which>] [cancelOnZero=<bool>] [cancelOnFlip=<bool>]Note: Both smart-oco and oco smart are equivalent. Use whichever feels more natural to you.
Parameters
<which>OptionalType: keyword or tag | Default: all
Which orders to monitor. Determines the order list ONCE at startup:
| Value | Orders Monitored |
|---|---|
all | All open orders for this symbol (default) |
session | Only orders created in this webhook execution |
buy or long | All buy/long orders only |
sell or short | All sell/short orders only |
#tag | Orders with specific tag (e.g., #entry) |
cancelOnZeroOptionalDefault: trueType: boolean | Values: true, false | Default: true
Controls whether to cancel monitored orders when position size goes to zero:
cancelOnZero=true(recommended)Cancels orders when position closes. Prevents orphaned TP/SL orders.
cancelOnZero=falseKeeps orders active even when position closes. Use if you plan to re-enter.
cancelOnFlipOptionalDefault: trueType: boolean | Values: true, false | Default: true
Controls whether to cancel monitored orders when position direction flips:
cancelOnFlip=true(recommended)Cancels incompatible orders when position flips long to short or short to long.
Essential for exchanges without hedge mode.
cancelOnFlip=falseKeeps all orders active regardless of position direction.
Use only if you have hedge mode enabled and want complex strategies.
Real-World Examples
1. Smart OCO on All Orders (Default Behavior)
Enable smart OCO monitoring on all orders with default settings.
BTCUSDT on My_API_Key
// Enter position
market long 0.01
// Place TP and SL
limit short 100%p off e5% reduce
stoploss short 100%p off e2%
// Enable smart OCO with all defaults
smart-ocoMonitors all orders. If position closes or flips, orders are cancelled automatically. Cleanup is requested when the monitored position closes or changes side, not merely because one order fills.
2. Smart OCO Only on Sell Orders
Monitor only sell orders (TP/SL for long position) with smart features.
ETHUSDT on My_API_Key
market long 0.5
// Exit orders
limit short 50%p off e3% reduce
stoploss short 100%p off e1.5%
limit short 50%p off e6% reduce
// Smart OCO only on sell orders
smart-oco sellOnly sell orders are monitored. If you have buy entry orders, they won't be affected by the smart OCO logic.
3. Disable Auto-Cancel on Position Flip
Keep orders active when position flips, but still cancel when position closes.
BTCUSDT on My_API_Key
market long 0.01
limit short 100%p off e4% reduce
stoploss short 100%p off e2%
// Smart OCO but keep orders on flip
smart-oco sell cancelOnZero=true cancelOnFlip=falseOrders are cancelled if position goes to zero, but NOT if position flips direction. Useful for advanced strategies where you want orders to survive direction changes.
4. Smart OCO with Tagged Orders
Monitor only orders with a specific tag, perfect for complex multi-level strategies.
BTCUSDT on My_API_Key
market long 0.02
// Primary exits (tight)
limit short 50%p off e2% reduce #primary
stoploss short 50%p off e1% #primary
// Secondary exits (wide)
limit short 50%p off e5% reduce #secondary
// Smart OCO only on primary group
smart-oco #primaryOnly #primary tagged orders have smart OCO monitoring with default close/flip settings. The #secondary order remains independent.
5. Complete Setup: Entry + TP + SL + Smart OCO
Full trading setup with position entry, exits, and intelligent monitoring.
BTCUSDT on My_API_Key
// Clean slate
rem all
pos 0
// Enter long position
market long 0.01
// Take profit levels
limit short 30%p off e3% reduce #tp1
limit short 40%p off e5% reduce #tp2
limit short 30%p off e8% reduce #tp3
// Stop loss
stoploss short 100%p off e2% #sl
// Smart monitoring
smart-oco sellComplete risk management: 3-level scaled take profits + stop loss, all monitored by smart-oco. If position closes manually or flips, all exit orders are cancelled automatically.
6. Position Flip Scenario with Auto-Cancel
Demonstrate how smart-oco protects you when position flips direction.
BTCUSDT on My_API_Key
// Start with long position
market long 0.01
limit short 100%p off e4% reduce #tp
stoploss short 100%p off e2% #sl
smart-oco sell
// --- Later: position flips to short ---
// (e.g., via manual trade or another webhook)
// smart-oco automatically cancels the sell orders
// because they're now incompatible with short positionWhen position flips from long to short, smart-oco detects the change and cancels all sell orders (which were meant to close long, but would now ADD to short position).
When to Use smart-oco
Protection from Orphaned Orders After Position Flip
If you close a long position and immediately open a short (or vice versa), old TP/SL orders become dangerous.smart-oco automatically cancels them, preventing accidental execution in the wrong direction.
Trading with Hedge Mode Disabled
Without hedge mode, you can't have both long and short positions simultaneously. smart-ocoensures old orders don't interfere when you switch sides. This is CRITICAL on most exchanges.
Strategies with Multiple Entry Points
If you have multiple entry orders and position management orders, smart-oco keeps everything synchronized. When position closes, all related orders are cleaned up automatically.
Manual Position Management
If you sometimes close positions manually via TradingView or exchange UI, smart-ocodetects the closure and cancels webhook-placed orders automatically. Inspect the cancellation results.
Best Practices
Use default settings initially -
smart-ocowithout parameters is usually the best starting point (both cancelOnZero and cancelOnFlip enabled)Essential without hedge mode - If your exchange doesn't support hedge mode, ALWAYS use
smart-ocoinstead ofocoUse specific scopes - Instead of
smart-oco all, prefersmart-oco sellorsmart-oco #tagfor better controlTest with small positions first - Understand how position monitoring works before using in production
Combine with session scope for safety - Use
smart-oco sessionto avoid affecting old orders from previous webhooksMonitor execution history - Check logs to verify smart-oco is cancelling orders as expected
Related Commands
oco- Standard OCO monitoring (order fills only, no position tracking)
reset-oco- Stop all OCO monitoring processes
position- View or modify current position (what smart-oco monitors)
sl-or-tp- Combined SL+TP with automatic OCO (simpler alternative for basic setups)
rem- Manually cancel orders