SwingHigh (Function)

The SwingHigh function returns the high pivot price where a Swing High occurred.

Syntax

SwingHigh(Instance, Price, Strength, Length)

Returns (Double)

A numeric value containing the high pivot price where the specified Swing High occurred, or -1 if not found.

Parameters

Name	Type	Description
Instance	Numeric	Sets which occurrence (that is, 1 = most recent, 2 = 2nd most recent, and so on) to return.
Price	Numeric	Specifies which bar value (price, function, or formula) to use.
Strength	Numeric	Sets the required number of bars on either side of the swing bar.
Length	Numeric	Sets the number of bars to be considered.

Remarks

A Swing High occurs when the Price of a bar is at least as high as the same Price on the preceding bar(s), and higher than the same Price on the bar(s) that follow it.

The input Strength is the number of bars on each side of the SwingHigh. A strength of one indicates that the value returned by the input Price must be greater than or equal to the same value returned for the bar on its left and greater than the bar on its right.

The input Length refers to the number of bars being examined for the SwingHigh.

The input Instance refers to which SwingHigh you want to use. For example, if in a twenty-one bar period three swing highs were found, it becomes necessary to specify which SwingHigh is desired. If the most recent SwingHigh is desired, a one (1) would be substituted for the input Instance.

If no SwingHigh is found in the period (Length) specified, the function will return a minus one (-1). The value of the input Length must exceed Strength by at least one. In addition, the Maximum number of bars referenced by a study (known as MaxBarsBack) must be greater than the sum of the values of Strength and Length.

Example

Assigns to Value1 the most recently occurring High in over the last 10 bars that has a strength of 4 on both the left and right sides of the swing bar..

Value1 = SwingHigh(1,Close,4,10);