Difference between revisions of "Portfolio SetMaxPotentialLossPerContract"

From MultiCharts
Jump to navigation Jump to search
m
 
Line 1: Line 1:
Redefines the values for the indicated symbol. The values in the '''$''' box if the [[Portfolio Settings|Absolute Max Potential Loss]] option is selected or the values in the % box if the [[Portfolio Settings|Max Potential Loss]] is selected.  
+
Redefines the values for the indicated symbol. The values in the '''¤''' box if the [[Portfolio Settings|Absolute Max Potential Loss]] option is selected or the values in the '''%''' box if the [[Portfolio Settings|Max Potential Loss]] is selected.
 +
 
 +
The newly set value is valid during the strategy calculation or until the '''Portfolio_SetMaxPotentialLossPerContract''' is requested again assigning a new value.  
  
The newly set value is valid during the strategy calculation or until the '''Portfolio_SetMaxPotentialLossPerContract''' is assigned a new value.
 
 
 
== Usage ==
 
== Usage ==
 
<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(NewValue);</syntaxhighlight>  
 
<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(NewValue);</syntaxhighlight>  
Line 9: Line 9:
  
 
:'''NewValue''' - a numerical value that can be:  
 
:'''NewValue''' - a numerical value that can be:  
::* An absolute value in the range [-100, -0.001]; defines percentage of the maximum potential loss per contract. (Max Potential Loss: %)  
+
::* An absolute value in the range [-100, -0.001]; defines percentage of the maximum potential loss per contract. (Max Potential Loss: %).
::* a value in the range [0.001, 1e+29]; defines the maximum potential loss per contract in dollars. (Absolute Max Potential Loss: $)  
+
::* a value in the range [0.001, 1e+29]; defines the maximum potential loss per contract in dollars. (Absolute Max Potential Loss: ¤).
::* equal 0; in this case the value entered in the '''Format Settings''' dialog window under the [[Portfolio Settings]] tab is used.  
+
::* equal 0; in this case the value entered in the '''Format Settings''' dialog window under the [[Portfolio Settings]] tab is used.
  
 
'''Portfolio_SetMaxPotentialLossPerContract''' returns:  
 
'''Portfolio_SetMaxPotentialLossPerContract''' returns:  
* True if the value is in one of the ranges indicated above. Redefining is considered to be successful.  
+
* True if the value is in one of the ranges indicated above. Redefining is considered to be successful.
* False if the if the value is out of the ranges indicated above. Redefining is considered unsuccessful and the '''Max Potential Loss value''' is unchanged.  
+
* False if the value is out of the ranges indicated above. Redefining is considered unsuccessful and the '''Max Potential Loss value''' is unchanged.
+
 
 
== Notes ==
 
== Notes ==
* This function can only be used in signals intended to be used with the [[:Category:Portfolio_Backtesting|Portfolio Backtester]].
+
* 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 ==
 
== Examples ==
Line 28: Line 29:
  
 
<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(200);</syntaxhighlight>
 
<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(200);</syntaxhighlight>
Redefines the maximum potential loss per contract for $200.
+
Redefines the maximum potential loss per contract for ¤200.
 +
 
 +
 
  
 
[[Category:Portfolio Strategy Position]]
 
[[Category:Portfolio Strategy Position]]

Latest revision as of 12:35, 25 July 2014

Redefines the values for the indicated symbol. The values in the ¤ box if the Absolute Max Potential Loss option is selected or the values in the % box if the Max Potential Loss is selected.

The newly set value is valid during the strategy calculation or until the Portfolio_SetMaxPotentialLossPerContract is requested again assigning a new value.

Usage

Portfolio_SetMaxPotentialLossPerContract(NewValue);

Parameters

NewValue - a numerical value that can be:
  • An absolute value in the range [-100, -0.001]; defines percentage of the maximum potential loss per contract. (Max Potential Loss: %).
  • a value in the range [0.001, 1e+29]; defines the maximum potential loss per contract in dollars. (Absolute Max Potential Loss: ¤).
  • equal 0; in this case the value entered in the Format Settings dialog window under the Portfolio Settings tab is used.

Portfolio_SetMaxPotentialLossPerContract returns:

  • True if the value is in one of the ranges indicated above. Redefining is considered to be successful.
  • False if the value is out of the ranges indicated above. Redefining is considered unsuccessful and the Max Potential Loss value is unchanged.

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

If "MSFT" = SymbolName then Portfolio_SetMaxPotentialLossPerContract(-10);

The new value of -10 is assigned for the symbol "MSFT" only if such symbol is exist in the portfolio.

Portfolio_SetMaxPotentialLossPerContract(-5);

Redefines the percentage value of the maximum potential loss per contract for 5%.

Portfolio_SetMaxPotentialLossPerContract(200);

Redefines the maximum potential loss per contract for ¤200.