Buy: Difference between revisions
m (Reverted edits by 176.8.90.7 (talk) to last revision by 194.84.116.138) |
m (→Entry types) |
||
(6 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
The entry point is visually indicated on a chart by an Arrow and a Tick. The Arrow identifies the time and the Tick identifies the price value of the entry point. Labels, displaying the entry name and the number of contracts or shares traded, are displayed below the Buy Arrow. | The entry point is visually indicated on a chart by an Arrow and a Tick. The Arrow identifies the time and the Tick identifies the price value of the entry point. Labels, displaying the entry name and the number of contracts or shares traded, are displayed below the Buy Arrow. | ||
An order is executed at the point specified by the parameters; if the order is not filled within the specified bar, the order is cancelled. | <div style="background-color: #FFE4E1;margin-bottom:10px;">An order is executed at the point specified by the parameters; if the order is not filled '''within''' the specified bar, the order is '''cancelled'''.</div> | ||
When a Buy order is filled, any open short positions will also be closed. | When a Buy order is filled, any open short positions will also be closed. | ||
== Usage == | |||
<syntaxhighlight>Buy[("EntryLabel")][TradeSize]EntryType;</syntaxhighlight> | <syntaxhighlight>Buy[("EntryLabel")] [TradeSize] EntryType;</syntaxhighlight> | ||
Parameters inside the square brackets are optional | Parameters inside the square brackets are optional - if these aren't defined, the default is used. | ||
== Parameters == | |||
:'''EntryLabel''' - an optional parameter; assigns a name that will be displayed in the name label below the entry, and can be used to identify the particular entry and to tie an exit to it. | |||
::An exit can only be tied to an entry within the same signal; for more information, see [[Sell]]. | |||
::If '''EntryLabel''' is not specified, the name "Buy" will be used for the first entry, "Buy#2" for the second entry, "Buy#3" for the third entry, etc. | |||
:'''TradeSize''' - an optional parameter; a numerical expression, specifying the number of contracts or shares to buy; the expression must be followed by one of the following equivalent words: [[Share]], [[Shares]], [[Contract]] or [[Contracts]]. | |||
::If '''TradeSize''' value equals 0 or is negative, a long position will not be entered but any open short positions will be closed. | |||
::If '''TradeSize''' is not specified, the trade size value set by the user in the Properties tab of the Strategy Properties window will be used. | |||
:'''EntryType''' - a required parameter; specifies the timing and price of entry. See below for more information about the EntryType. | |||
== Entry types == | |||
There are four kinds of EntryType: | There are four kinds of EntryType: | ||
<syntaxhighlight>This Bar | === Enter this bar on close === | ||
<syntaxhighlight>This Bar On Close</syntaxhighlight> | |||
Where: - [[ | Where: | ||
:'''On''' - is a [[:Category:Skip_Words|skip word]] and can be omitted. | |||
A Buy Arrow will be placed at the current bar's [[Close]] tick. | A Buy Arrow will be placed at the current bar's [[Close]] tick. | ||
<syntaxhighlight>Next Bar | === Enter next bar at open === | ||
<syntaxhighlight>Next Bar At Open</syntaxhighlight> | |||
or | |||
<syntaxhighlight>Next Bar At Market</syntaxhighlight> | |||
Where: | Where: | ||
:Words '''"Market"''' and '''"Open"''' are interchangeable. | |||
- [[ | :'''At''' - is a [[:Category:Skip_Words|skip word]] and can be omitted. | ||
A Buy Arrow will be placed at the next bar's [[Open]] tick. | A Buy Arrow will be placed at the next bar's [[Open]] tick. | ||
<syntaxhighlight>Next Bar | === Enter next bar at limit === | ||
<syntaxhighlight>Next Bar Price Limit</syntaxhighlight> | |||
Where: - | Where: | ||
:'''Price''' - a numerical expression, specifying the Limit Price. | |||
- [[ | :'''At''' - a [[:Category:Skip_Words|skip word]] word and can be omitted. | ||
A Buy Arrow will be placed on the next bar at the first tick with a price value less than or equal to | A Buy Arrow will be placed on the next bar at the first tick with a price value less than or equal to '''Price'''; if there are no such ticks within the next bar, the order will be cancelled. | ||
<syntaxhighlight>Next Bar | === Enter next bar at stop === | ||
<syntaxhighlight>Next Bar At Price Stop</syntaxhighlight> | |||
Where: - | Where: | ||
:'''Price''' - a numerical expression, specifying the Stop Price. | |||
- [[ | :'''At''' - a [[:Category:Skip_Words|skip word]] and can be omitted. | ||
A Buy Arrow will be placed on the next bar at the first tick with a price value equal to or greater than the | A Buy Arrow will be placed on the next bar at the first tick with a price value equal to or greater than the '''Price'''; if there are no such ticks within the next bar, the order will be cancelled. | ||
== | == Examples == | ||
Buy a user-set number of shares at Market price on close of this bar: | Buy a user-set number of shares at Market price on close of this bar: | ||
Line 79: | Line 82: | ||
<syntaxhighlight>Buy 10 Contracts Next Bar 50 Stop;</syntaxhighlight> | <syntaxhighlight>Buy 10 Contracts Next Bar 50 Stop;</syntaxhighlight> | ||
[[Category:Strategy Orders]] | [[Category:Strategy Orders]] |
Latest revision as of 17:08, 19 February 2012
Enters a long position as specified by the parameters. The entry point is visually indicated on a chart by an Arrow and a Tick. The Arrow identifies the time and the Tick identifies the price value of the entry point. Labels, displaying the entry name and the number of contracts or shares traded, are displayed below the Buy Arrow.
When a Buy order is filled, any open short positions will also be closed.
Usage
Buy[("EntryLabel")] [TradeSize] EntryType;
Parameters inside the square brackets are optional - if these aren't defined, the default is used.
Parameters
- EntryLabel - an optional parameter; assigns a name that will be displayed in the name label below the entry, and can be used to identify the particular entry and to tie an exit to it.
- An exit can only be tied to an entry within the same signal; for more information, see Sell.
- If EntryLabel is not specified, the name "Buy" will be used for the first entry, "Buy#2" for the second entry, "Buy#3" for the third entry, etc.
- TradeSize - an optional parameter; a numerical expression, specifying the number of contracts or shares to buy; the expression must be followed by one of the following equivalent words: Share, Shares, Contract or Contracts.
- If TradeSize value equals 0 or is negative, a long position will not be entered but any open short positions will be closed.
- If TradeSize is not specified, the trade size value set by the user in the Properties tab of the Strategy Properties window will be used.
- EntryType - a required parameter; specifies the timing and price of entry. See below for more information about the EntryType.
Entry types
There are four kinds of EntryType:
Enter this bar on close
This Bar On Close
Where:
- On - is a skip word and can be omitted.
A Buy Arrow will be placed at the current bar's Close tick.
Enter next bar at open
Next Bar At Open
or
Next Bar At Market
Where:
- Words "Market" and "Open" are interchangeable.
- At - is a skip word and can be omitted.
A Buy Arrow will be placed at the next bar's Open tick.
Enter next bar at limit
Next Bar Price Limit
Where:
- Price - a numerical expression, specifying the Limit Price.
- At - a skip word word and can be omitted.
A Buy Arrow will be placed on the next bar at the first tick with a price value less than or equal to Price; if there are no such ticks within the next bar, the order will be cancelled.
Enter next bar at stop
Next Bar At Price Stop
Where:
- Price - a numerical expression, specifying the Stop Price.
- At - a skip word and can be omitted.
A Buy Arrow will be placed on the next bar at the first tick with a price value equal to or greater than the Price; if there are no such ticks within the next bar, the order will be cancelled.
Examples
Buy a user-set number of shares at Market price on close of this bar:
Buy This Bar On Close;
Buy 1 share at Market price on open of next bar and label the entry "Entry":
Buy("Entry")1 Share Next Bar At Open;
Buy 1 contract at Market price on open of next bar and label the entry "Entry":
Buy("Entry")1 Contract Next Bar Market;
Buy 2 shares within the next bar on the first tick with a price of 100 or less:
Buy 2 Shares Next Bar At 100 Limit;
Buy 10 contracts within the next bar on the first tick with a price of 50 or more:
Buy 10 Contracts Next Bar 50 Stop;