Difference between revisions of "Portfolio CalcMaxPotentialLossForEntry"

From MultiCharts
Jump to navigation Jump to search
(Created page with "Calculates and returns maximum potential loss (not including margin, commision or slippage) if user entered the position with the number of Contracts and Price of entr...")
 
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Calculates and returns maximum potential loss (not including margin, commision or slippage) if user entered the position with the number of [[Contracts]] and [[Price]] of entry.   
+
Calculates and returns the maximum potential loss (not including margin, commission or slippage) if the user entered the position with the number of [[Contracts]] and [[EntryPrice|Price of entry]].   
  
==== Usage ====
+
== Usage ==
 
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (Side <,Contracts <,Price>>);</syntaxhighlight>  
 
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (Side <,Contracts <,Price>>);</syntaxhighlight>  
  
Parameters inside the angled brackets are optional  
+
Parameters inside the angled brackets are optional - if these aren't defined, the default is used.
  
==== Parameters ====
+
== Parameters ==
 +
:'''Side''' - a numerical expression specifying the entry type (e.g. 1 Long entry or -1 Short entry).
 +
:'''Contracts''' - an optional parameter specifying the number of contracts.
 +
::If the Contracts parameter is not specified then the number of contracts indicated in the [[Portfolio Settings|Format Settings]] dialog window under the '''Properties''' tab is used by default.
 +
:'''Price''' - an optional parameter specifying the price value.
 +
::If the Price parameter is not specified, then the [[Close]] price value of the current bar will be used by default. This parameter can be rounded down if entered a Short position or rounded up if entered a Long position.
  
Side is a numerical expression specifying the entry type (e.g. 1 Long entry or -1 Short entry).  
+
== Notes ==
 +
This function can only be used in signals intended to be used with the Portfolio Trader.  
  
[[Contracts]] is an optional parameter specifying the number of contracts. If the Contracts parameter is not specified, then the number of contracts indicated in the [[Format Settings]] dialog window under the [[Properties]] tab is used by default.  
+
The value is returned in the currency specified in Portfolio Trader: '''Portfolio Settings -> Base Currency.'''
 +
 +
== Examples ==
 +
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (0, 25, High)</syntaxhighlight>
 +
Will return a value of 0, since the parameter ''Side'' is 0.
 +
 
 +
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (1, 100, Close)</syntaxhighlight>
 +
Will return the maximum potential loss (not including margin, commission or slippage) if user entered a Long position for 100 contracts at the Close price.  
  
[[Price]] is an optional parameter specifying the price value. If the Price parameter is not specified, then the Close price value of the current bar will be used by default. This parameter can be rounded down if entered a Short position or rounded up if entered a Long position.
+
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (-1, 5, Open)</syntaxhighlight>
+
Will return the maximum potential loss (not including margin, commission or slippage) if user entered a Short position for 5 contracts at the Open price.
==== Notes ====
 
This function can only be used in signals intended to be used with the Portfolio Backtester.
 
 
==== Example ====
 
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (0, 25, High) will return a value of 0, since the parameter Side=0
 
  
Portfolio_CalcMaxPotentialLossForEntry (1, 100, Close) will return the maximum potential loss (not including margin, commision or slippage) if user entered a Long position for 100 contracts at the Close price.  
+
<syntaxhighlight>Portfolio_CalcMaxPotentialLossForEntry (1)</syntaxhighlight>
 +
Will return the maximum potential loss (not including margin, commission or slippage) if the user entered a Long position for a number of contracts indicated in the Format Settings dialog window under the Properties tab at the Close price.
  
Portfolio_CalcMaxPotentialLossForEntry (-1, 5, Open) will return the maximum potential loss (not including margin, commision or slippage) if user entered a Short position for 5 contracts at Open price.
 
  
Portfolio_CalcMaxPotentialLossForEntry (1) will return the maximum potential loss (not including margin, commision or slippage) if the user entered a Long position for a number of contracts indicated in the Format Settings dialog window under the Properties tab at Close price.</syntaxhighlight>
 
  
  
 
[[Category:Portfolio Strategy Position]]
 
[[Category:Portfolio Strategy Position]]

Latest revision as of 18:57, 24 July 2014

Calculates and returns the maximum potential loss (not including margin, commission or slippage) if the user entered the position with the number of Contracts and Price of entry.

Usage

Portfolio_CalcMaxPotentialLossForEntry (Side <,Contracts <,Price>>);

Parameters inside the angled brackets are optional - if these aren't defined, the default is used.

Parameters

Side - a numerical expression specifying the entry type (e.g. 1 Long entry or -1 Short entry).
Contracts - an optional parameter specifying the number of contracts.
If the Contracts parameter is not specified then the number of contracts indicated in the Format Settings dialog window under the Properties tab is used by default.
Price - an optional parameter specifying the price value.
If the Price parameter is not specified, then the Close price value of the current bar will be used by default. This parameter can be rounded down if entered a Short position or rounded up if entered a Long position.

Notes

This function can only be used in signals intended to be used with the Portfolio Trader.

The value is returned in the currency specified in Portfolio Trader: Portfolio Settings -> Base Currency.

Examples

Portfolio_CalcMaxPotentialLossForEntry (0, 25, High)

Will return a value of 0, since the parameter Side is 0.

Portfolio_CalcMaxPotentialLossForEntry (1, 100, Close)

Will return the maximum potential loss (not including margin, commission or slippage) if user entered a Long position for 100 contracts at the Close price.

Portfolio_CalcMaxPotentialLossForEntry (-1, 5, Open)

Will return the maximum potential loss (not including margin, commission or slippage) if user entered a Short position for 5 contracts at the Open price.

Portfolio_CalcMaxPotentialLossForEntry (1)

Will return the maximum potential loss (not including margin, commission or slippage) if the user entered a Long position for a number of contracts indicated in the Format Settings dialog window under the Properties tab at the Close price.