Commerce Planner ver 1.3 – USER MANUAL – Different – 19 November 2025

INTRODUCTION

Commerce Planner is a cash administration software that helps management and analyze a number of potential account eventualities inside a buying and selling account.

On the core of this system lie two primary buying and selling parts:

• VPO — digital positions, pending orders, or open positions.
• EP — analysis factors appearing as goal ranges that outline distinct account eventualities.

By default, a newly created VPO features as a innocent digital place commerce level. It doesn’t expose your actual account to any danger, but it has all the mandatory properties to plan and put together trades successfully, equivalent to inserting pending orders.

When VPOs of any commerce kind are linked with Analysis Factors (EPs), the Commerce Planner supplies perception into how key account parameters — together with fairness, free margin, and margin stage — would change, making an allowance for the earnings and swaps of the linked VPOs. This permits merchants to anticipate outcomes and handle danger extra successfully earlier than important market actions happen.

QUICK INSTALLATION

This system features as an Skilled Advisor, permitting it to position pending orders and handle open trades. To allow order administration, each “Algo Buying and selling” and “Permit Algo Buying and selling” have to be switched on. 

Additionally, examine that One-Click on Buying and selling is enabled within the terminal choices underneath the “Commerce” tab.

Instruction how one can set up The Commerce Planner

FIRST STEPS IN THE TRADE PLANNER

Including buying and selling factors (VPOs) and analysis level (EP).

Working with VPO-EP strains.

VPO Panel and inserting pending orders.

The best way to connect VPOs buying and selling objects to open positions.

TRADE PLANNER’S GRAPHICAL USER INTERFACE (GUI)

Image 1. Commerce planner’s graphical consumer interface (GUI).

1. Foremost Panel – Consists of: presets controls (a) and program instruments (b).

1a. Presets controls  – permits to avoid wasting present objects state (format) at totally different quantity (as much as 10 presets) per image. This half consists of following parts:

• Numeric enter field permits change presets by mouse wheel up / down or duplicate current preset to some other – enter a area by mouse click on and kind any quantity in vary 1 – 10, then press ENTER. Present format will probably be saved on a desired preset program quantity.

• The left and proper arrows for fast transfer to the earlier or subsequent preset.

• The Save, Reload, and Reset buttons mean you can save the present format, reload the final saved model, or reset the whole lot to the default preset that begins with a single analysis level.

Right here’s the animation displaying how one can use this part.

1b. Program instruments which incorporates following features:

• Attaching VPO objects to current positions (ATT ➔ POS) or pending orders (ATT ➔ P/OR). Earlier than use, make a positive that correct magic variety of tracked EA is ready (see “Enter parameters” part). By default 0 corresponds to all pending orders / open positions for chart image. As soon as the hooked up VPOs are created, most parameters will be modified apart from the amount, commerce route, and remark for this commerce level — identical to within the terminal.
• ”AUTO-PRF” checkbox. As soon as VPOs are linked to EP and ”AUTO-PRF” checkbox is enabled, the EP costs will probably be adjusted to assumed revenue (see “Enter parameters” → “”AUTO-PRF” revenue worth (acc. forex). For instance it’s attainable to routinely discover breakeven stage for VPO group linked to EP, by altering quantity, value, commerce of any VPO regardless is it digital place, pending order or open place.

Within the case of hedged EP positions (BUY quantity = SELL quantity), the calculated revenue stays virtually unchanged no matter altering EP value. Due to this fact, this characteristic is irrelevant on this scenario.

• Alarm change button notify consumer if distance between present value and any VPO is much less or equal to worth decided in enter parameters.
• Present / cover objects button.
• Lock / unlock objects button.

2. VPO Desk

A listing of all VPOs helps you establish and entry any buying and selling level when a number of VPO objects overlap on the chart. To focus on a particular buying and selling level, use the left mouse button or the navigation arrows situated within the top-right nook of the desk. When numerous VPOs is current, a further arrow seems on the correct aspect of the desk that will help you rapidly find the chosen entry within the checklist.

See an instance under how one can use the desk. Column with the TT title signifies the Commerce Path (commerce pattern), displaying whether or not the buying and selling level is ready to BUY or SELL.

3. Analysis level (EP)

It is a time-price level appearing as separate account (or sub-account) standing based mostly on allocate capital. Right here, complete earnings and swaps are calculated from linked VPOs. EP label situated above circle consists of :

• P/L – EP summarized revenue or loss (account forex)
• SW – EP summarized swap (account forex)
• B – EP steadiness (account forex)
• E – EP fairness (account forex)
• FrM – EP free margin(account forex)
• ML – EP margin stage (%)

3A, 3B – A and B corresponds to “optimistic” and “pessimistic” state of affairs, respectively.

For hedged positions linked to EP (if complete quantity for BUY positions = complete quantity of SELL positions), further *HED* message seems within the label.

4. VPO commerce level

It represents a buying and selling factor that may perform as a digital place, a pending order, or an actual open place. It supplies all the mandatory parameters—equivalent to quantity, commerce route, and value ranges—for making ready risk-management setups, inserting pending orders, and managing open trades.

5. VPO panel.

It is a management panel that gives further parameters for making ready or modifying pending orders or open positions. Under is the checklist of controls contained in the panel.

Image 2. VPO Panel management. As soon as VPO will probably be open, quantity, commerce route and lock controls will routinely shift to the highest / backside place of this panel.

• Cease-Loss / Take-profit stage controls. Commerce Planner permits you to set protecting orders both from the VPO Panel or straight utilizing VPO circles. The latter methodology will be utilized by holding the SHIFT key and hovering the mouse over a VPO circle, then dragging it up or down to regulate the specified Cease-Loss or Take-Revenue distance from the VPO’s open value. 

The Commerce Planner additionally makes it attainable to examine how the EP steadiness could be affected when the worth hits any order of a linked VPO.

Under is a fast instruction how one can set protecting orders.

• Expiration time kind determines mode of order expiration.

Order Time Kind	Description
GTC	Good until canceled (not relevant for “order time expiration”)
TIME DAY	Till finish of day
TIME SPEC.	Good until specified time
TIME SPEC. DAY	Good until specified day

• Order kind. Primarily based on VPO commerce route program routinely set correct order kind to position in line with situations introduced within the desk under.

Order Kind	Putting order situation
BUY LIMIT	VPO open value
BUY STOP	VPO open value > Ask value
SELL LIMIT	VPO open value > Bid value
SELL STOP	VPO open value
NONE	Bid value ≤ VPO open value ​ ≤ Ask value

• Expiration time of positioned order.
• Remark for any kind of commerce. Please remember that for a pending order or an open place, this parameter can’t be modified.
• Place / modify pending order.
• Delete pending order / shut open place.

6. VPO quantity, commerce route and lock controls.

On this half quantity dimension will be change by few strategies utilizing:

• “Plus” and “minus” buttons by step outlined in a logo specification.
• Typing quantity within the quantity edit area. If consumer enters e.g. “0,23” or “,23”, program routinely converts the textual content enter into the quantity “0.23”.

Subsequent to the amount controls, there are toggle buttons used to alter the commerce route and to lock all VPO parameters, respectively.

7. Label with revenue, value distance (factors) and swap for every VPO-EP connection.

8. Details about VPO / EP that means and fundamental program hotkeys.

9. Margin name or cease out warning (situated at EP value line).

As soon as VPOs are linked to EP, it’s attainable to discover a value at which margin name or cease out stage could happens. This may be performed simply, by dragging EP circle (or its value line) to desired value. Cease-out and Margin-Name ranges will be modified from ”enter” paramaters tab.

INPUT PARAMETERS

A. Basic settings – Introducing the important thing parameters essential to work with VPOs / EPs.

• Reserved steadiness – This worth corresponds to amount of money (in account forex) you might be planning to make use of in commerce per image. By default steadiness account is used (0 – worth). It’s attainable to enter a price greater than the funds presently within the account if further deposits are deliberate and also you wish to check capital distribution.
• ”AUTO-PRF” revenue worth – units the goal revenue stage at which the Analysis Level (EP) value is routinely calculated from the parameters of the linked VPO buying and selling objects.

• Margin Name stage (%) and Cease out stage (%) – Threshold values of margin stage necesseary for notification (showing above EP horizontal value line) if fairness stage is round margin name or cease out. Merely transfer EP circle / value line on a chart to see the outcome.
• Embrace swap in fairness – Add a swap contribution to an EP fairness.
• Ignore calculations if VPO open time > EP time – If FALSE, calculation will probably be carried out provided that VPO time is sooner than EP time, as this represents a sensible state of affairs.
• Magic Quantity for place pen. orders – This quantity will probably be added to pending orders positioned by Commerce Planner. As soon as they are going to be executed, commerce will open with this quantity additionally.
• Magic Variety of tracked EA – This parameter is required for attaching the Commerce Planner to pending orders or open positions that use this Magic Quantity. When set to 0, all trades for the image are taken into consideration by default.
• Lock VPOs when hooked up to positions / orders – When attaching to place / pending orders process is activated, all parameters of newly created VPOs can’t be modified. This characteristic defend hooked up object for unintentional change.

B. Alert.

Earlier than utilizing the next enter parameters, be certain that the alert icon on the primary program panel (see part 1b within the TRADE PLANNER’S GRAPHICAL USER INTERFACE (GUI) handbook) is inexperienced. The alert state (ON/OFF) is saved for every preset.

• Worth distance (factors) to VPO – If value is inside distance to VPO, alert will probably be triggered.
• Set a reminder each X seconds – Alert will set off each X seconds repeatedly. Till consumer disable it by toggle alert button (to crimson colour)
• One-shot alert (if true, reminder is disabled) – If switched on, alert set off solely as soon as for met situation. If distance between value and VPO value will probably be greater than threshold and value again near VPO (inside distance), alert will probably be triggered once more.
• Ship notification when alert – Ship alert message to Meta Dealer 5 cell utility.

C. Fashion, colours, view.

• GUI scale (%) – Dimension GUI program for consumer consolation. Nonetheless, please notice that prime worth can influence program efficiency, as a result of Commerce Planner have to attract extra pixels.
• GUI type – Choose possibility regarding graphical type of GUI:

• “no circles” draw solely chosen / hovered circles for VPO or SP, different circles are skipped,
• „easy” draw much less objects ( greater efficiency),
• „fancy” provides greater visibility of VPOs for efficiency value.

• GUI line thickness – Set thickness of all strains drawn in program.
• EP / VPO description font dimension – Select small or regular font dimension for EP and VPO-EP labels.
• Shade for BUY / SELL / PROFIT / LOSS / NONE accordingly – Change largely used colours. Shade None representing conditions the place revenue is the same as zero, EP is remoted (VPOs not linked), VPO – EP strains(s) are bypassed.
• The primary panel chart place – Foremost panel localization on the chart.
• VPO’s quantity, commerce route, lock chart positions – Units the place of quantity, commerce route, and lock alongside the VPO horizontal value line.
• Preserve VPO Panel seen on a regular basis – When drag VPO circle, this panel is seen on a regular basis till consumer shut it by “ESC” key or shut button inside panel (cross).
• Present all VPO-EP strains descriptions – If set to FALSE, this system hides all labels on VPO–EP strains. Swap and revenue info is displayed just for the VPO–EP line presently hovered by the mouse.
• Present SL/TP outcomes for all VPOs – Show potential revenue or loss for all VPOs in line with their SL/TP ranges.
• Present VPO desk – Shows a desk with all VPO buying and selling objects. Helpful when there are lots of VPOs or when two or extra trades are very shut and onerous to tell apart visually. You may simply navigate to any object by clicking its row.

D. Hotkeys

On this part, it’s attainable to customise vital hotkeys for a greater workflow. See description in ”inputs” tab in a dialog window of program. Full checklist of used shortcuts is introduced in ADDITIONAL NOTES part of this text.

E. Misc. Settings.

• Presets folder situated within the “Information” listing – Enter a folder title to proceed working with the presets situated within the specified folder.
• Show hints when hovering over objects – Reveals further notes in regards to the hovered object, equivalent to: VPO Circle, VPO Horizontal Line, primary panel buttons and so forth.
• Show legend and hotkeys – Reveals some details about what’s VPO and EP objects and a few vital hotkeys for fundamental operations.
• Show warnings at program startup – Notify if there are issues with account or image information.

ADDITIONAL NOTES.

1. MONEY ALLOCATION

All metrics inside Analysis Factors are derived from the reserved capital and the buying and selling factors linked to them.

When analyzing a single image and the Reserved Cash parameter is ready to 0 (that means the complete account steadiness is utilized), the EP objects in Commerce Planner signify your precise account standing.

In each different scenario — equivalent to when different devices have already got open trades — every EP features as an impartial sub-account that makes use of solely a portion of your complete funds assigned to the analyzed image.

This setup reduces general publicity and limits danger in comparison with utilizing all the steadiness for one market.

You might also allocate extra digital capital than presently accessible in your account to simulate future deposits or discover higher-capital methods.

However, the consumer can even open a number of charts with Commerce Planner for a similar image, every utilizing a unique quantity of allotted capital to check and choose probably the most optimum buying and selling technique from the others chart.

Please select the quantity of allotted steadiness properly, because it straight impacts all calculated EP account parameters (fairness, free margin, margin stage, and so forth.).

Be aware that the reserved steadiness is used for calculation functions solely and does not have an effect on the precise margin or account steadiness on the buying and selling platform.

2. IMPROPER USE OF THE PROGRAM

When altering the amount dimension of linked VPO to an EP make a positive that EP free margin stays optimistic and no over-leveraged scenario will happen. Nonetheless, should you improve the amount whereas the free margin is already unfavorable, further warning messages could seem alongside the EP line.

Under is a full checklist of attainable errors which can occurred attributable to improper quantity dimension, quantity of allotted capital or if EP value is ready too low or excessive comparatively to linked buying and selling factors.

These warnings are:

• INVALID MARGIN LEVEL (ML 0)
• NEGATIVE FREE MARGIN WITH PROFIT
• INVALID MARGIN LEVEL (MARGIN USED = 0)
• FREE MARGIN TOO LOW
• EQUITY

3. HOW THE PROGRAM PERFORMS CALCULATIONS?

Margin and profit are calculated utilizing the native MetaTrader 5 features OrderCalcMargin and OrderCalcProfit based mostly on present market situations, permitting you to see how revenue would change if the market strikes to a particular value.

For probably the most dependable outcomes, it is strongly recommended to make use of buying and selling symbols whose revenue is straight denominated within the account forex (e.g., EURUSD when the account forex is USD). For symbols requiring cross-currency conversion, the system makes use of the newest alternate charges accessible on the time of calculation. For every image, the present revenue and swap of each open place linked to an analysis level embrace broker-provided information, with any further revenue or swap estimated based mostly on simulated value and time adjustments from the present market situations.

Swap fees are decided by the image specs (kind, relevant days, and values). Calculations cowl all normal swap modes besides Reopen positions. The reopen positions modes apply swaps through technical place rollover at a brand new value moderately than as curiosity or factors.

4. NOTES ABOUT MAGIC NUMBER SETTINGS.

Please, don’t confuse the magic quantity for putting pending orders with the magic variety of tracked Skilled-Advisor. First one corresponds to inserting orders by this program solely, the second is for attaching VPOs to orders / open positions created by one other EA. Nonetheless, consumer can use each, similar numbers for putting orders / opening positions simultaneous monitoring the identical kinds of trades.

Magic quantity 0 (zero) applies to all orders or open positions for the image.

5. KEYBOARD AND MOUSE SHORTCUTS

Here is an inventory of all shortcuts utilized in this system.

DESCRIPTION	SHORTCUT
Add VPO commerce level	“A” key (customizable)
Add EP analysis level	“S” key (customizable)
Choose VPO / EP	Left-click. To stop altering the VPO/EP place, maintain the CTRL key in the course of the operation.
Spotlight the connections for a particular VPO / EP object	Maintain SHIFT and hover over VPO / EP circle marker.
Join VPO to EP	Maintain CTRL and left-click on VPO circle, then drag towards any EP.
Join all VPOs to chose EP	“C” key (customizable)
Disconnect all VPOs from chosen EP (EP isolation)	“D” key (customizable)
Delete chosen EP / VPO	“DEL” key
Set VPO Cease-Loss / Take-Revenue	Maintain SHIFT and begin dragging up or down from the higher or decrease a part of the VPO circle. An extra crammed half-circle will seem contained in the VPO circle.
Show SL / TP ranges with costs for present VPO	Maintain SHIFT and hover over VPO Circle.
Transfer the chosen EP/VPO up or down alongside the worth axis.	arrow keys (↑ / ↓)
Conceal / present all Commerce Planner’s objects	“H” key (customizable)
Lock / unlock all Commerce Planner’s objects	“L” key (customizable)

When you’ve got any options or questions, be happy to ship me a personal message through MQL messenger.