Documentation

See exactly how the software works

Every page, feature, and risk control — explained in plain English. The same docs our members use, open for anyone to read.

Trading Concepts

When you're already in a trade and the same alert comes in again — same ticker, same strike, same expiration, same side — the bot normally adds to that position and averages it: the new contracts merge into your open trade at a blended price. That's "averaging in" (also called scaling in).

Allow Averaging is a per-strategy switch that lets you turn that off. When it's on (the default), nothing changes — repeat alerts average into the open trade just like always. When it's off, a repeat alert for a position you already hold is simply rejected: the strategy takes the position once and never adds to it.

You'll find it on the Strategies page, in a strategy's Risk & Orders tab under Allow Averaging. Like every other strategy setting, it's saved per strategy and takes effect right away — no restart needed.

The Allow Averaging toggle on the Strategies page

What counts as "the same"

Averaging only happens on the exact same contract — the same underlying, strike, expiration, and call/put. A different strike or expiration is a different position and is taken on its own.

  • SPY 760 call → SPY 760 call (same expiration) → same contract → averages in (or, with the switch off, is rejected).
  • SPY 760 call → SPY 755 call → different strike → a separate trade either way.

Example

Your strategy is holding a SPY 760 call and a second SPY 760 call alert comes in a few minutes later. With Allow Averaging on, the bot buys more and blends them into one averaged position. With the switch off, that second alert is turned away and you keep just the original position.

Manual scale-ins still work

The switch only governs automatic averaging from incoming alerts. If you deliberately press Scale In on a trade from your dashboard, that always goes through — turning Allow Averaging off never blocks a move you make by hand.

The same is true of a level you arm with Auto Scale-In. Arming one is you deciding to add, not an alert arriving, so it goes through even with this switch off — see that topic for the rest of what governs it.

Your average entry counts only what you still hold

When you add to a position you've already taken some profit on, the blended entry is worked out from the contracts you're still holding — not from the size you first opened.

That matters because a position that has hit a target or two is much smaller than it started. If only a sliver of the original entry is left, the price you paid for that sliver barely counts toward the new average, and the contracts you just added dominate it.

Example

You buy a QQQ 673 call at $0.87. Your first two exit targets hit and a stop takes a third slice, leaving about 20% of the position open. You then add at $0.58. Your average entry becomes about $0.63, close to the price you just paid. It is not $0.72, which is what you'd get by treating the two prices as equal halves when four-fifths of the first one has already been sold.

Your targets and stops are re-struck from the new average, so a lower average brings both down with it.

Trailing-stop trades average too

Trades running a Trailing Stop used to be the exception: a repeat alert on one was always turned away, whatever this switch said. That's no longer the case — they average in like any other trade, and the Scale In button appears on them as well. Your trailing stop is re-based sensibly either way, which is explained under Trailing Stop.

Futures strategies have their own switch

Everything above describes options strategies. A futures strategy has an Allow Averaging switch of its own, in the same place on its Risk & Orders tab — and it is a genuinely separate setting with different defaults and different rules. Setting one does not affect the other.

It starts OFF. That's the opposite of the options switch, and it's deliberate: adding to a futures position grows real contracts on a funded account much faster than it does on options. If you want a futures strategy to average, you have to say so.

With it on, a repeat alert in the same direction on a contract you already hold — another BUY NQ while you're long NQ — adds to the open position and blends the entry price. It stays one position that exits in one go, rather than two trades to manage. With it off, that repeat alert is ignored.

Warning

Paper futures only, for now. Neither Tradovate nor Plus500 accepts an add to an existing futures position yet, so on a live futures account the switch is on but every repeat alert is still refused. Use it on paper to see how a strategy behaves with averaging before live support arrives.

Three limits apply whichever way you set it:

  • Bracketed trades only. A repeat alert on a futures trade that's running a trailing stop is always ignored, even with the switch on. This is the opposite of how options behave — see the section above — and it's the one place the two switches genuinely differ in what they can do, not just in their default.
  • Max Contracts means the total. Your strategy's Max Contracts limit now applies to the combined position rather than to each entry. If you're capped at 3 and already holding 3, a repeat alert adds nothing. If you trade a funded or prop account with its own contract ceiling, that's checked on the add as well as on the first entry.
  • Only when the bot is certain which position you mean. A runner leg, or a second position in the same contract family that it can't tell apart from the one you're holding, is left alone rather than guessed at.

Each of those refusals now gives its own reason rather than one blanket message, so you can tell "your trail is armed" apart from "you're at your contract cap."

Example

A paper futures strategy with Contracts Per Trade of 1 and Max Contracts of 3 is long 1 NQ at 24,550.25. A second BUY NQ arrives and fills at 24,550.50. You now have one tracked trade of 2 contracts with an entry of 24,550.375 — the true blend, not rounded — and the target and stop are re-struck from that average onto NQ's own tick grid. A third alert takes you to 3; a fourth is ignored, because you're at your cap. With the switch off (the default), you'd still be long 1 NQ and every repeat alert would have been turned away.

Note

You'll only see this switch if your bot is on version 3.5.0 or newer — that's where the engine side of it lives. On an older bot the switch is hidden rather than shown, because a toggle for something your bot would refuse is worse than no toggle at all.

Note

If you import a shared setup code that doesn't mention futures averaging, it arrives off, not on. A preset should never quietly start growing positions on your account because of a setting its author never made a decision about.

Tip

Switch a strategy away from futures and this setting is cleared rather than kept — so it can't sit there invisibly and surprise you if you ever switch back.

Testing it first

The same switch is on the Backtest page, so you can see the difference before turning it on for real money. Run your strategy with averaging on and again with it off over a window where the same contract gets re-alerted — with it off, those repeat alerts are skipped instead of opening additional positions, so you can compare the results. See Backtest.

Tip

Allow Averaging only decides whether repeat alerts add to a position. Your Profit Target & Stop-Loss and every other exit rule still govern the position itself.