Difference between revisions of "Portfolio SetMaxPotentialLossPerContract"
Jump to navigation
Jump to search
(Created page with "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 Po...") |
|||
(2 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
− | Redefines the values for the indicated symbol. The values in the | + | 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 | + | |
− | + | The newly set value is valid during the strategy calculation or until the '''Portfolio_SetMaxPotentialLossPerContract''' is requested again assigning a new value. | |
− | + | ||
+ | == Usage == | ||
<syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(NewValue);</syntaxhighlight> | <syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(NewValue);</syntaxhighlight> | ||
− | + | == 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: | + | ::* 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 | + | ::* 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 | + | * True if the value is in one of the ranges indicated above. Redefining is considered to be successful. |
− | * False | + | * 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 == |
− | + | <syntaxhighlight>If "MSFT" = SymbolName then Portfolio_SetMaxPotentialLossPerContract(-10);</syntaxhighlight> | |
− | + | The new value of -10 is assigned for the symbol "MSFT" only if such symbol is exist in the portfolio. | |
− | + | ||
− | <syntaxhighlight>If "MSFT"=SymbolName then Portfolio_SetMaxPotentialLossPerContract (-10); | + | <syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(-5);</syntaxhighlight> |
− | assigned for the symbol "MSFT" only if such symbol is exist in the portfolio. | + | Redefines the percentage value of the maximum potential loss per contract for 5%. |
+ | |||
+ | <syntaxhighlight>Portfolio_SetMaxPotentialLossPerContract(200);</syntaxhighlight> | ||
+ | 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.
Contents
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.