GetHighestValue

Finds the highest value in a range of bars.

Syntax

GetHighestValue(valueType: TValueType, startPos: number, count: number): number

Parameters

• valueType: A TValueType enum value representing the type of price to analyze

• startPos: A number representing the starting position in the range

• count: A number representing the number of bars to analyze

Return Value

Returns a number representing the highest value found in the specified range.

Description

The GetHighestValue method searches for the highest value of a specified type (Open, High, Low, or Close) within a range of bars. The range starts at the specified position and includes the specified number of bars.

See TValueType for available price types:

• OPEN: Opening price of a bar/candle

• HIGH: Highest price of a bar/candle

• LOW: Lowest price of a bar/candle

• CLOSE: Closing price of a bar/candle

• VOLUME: Trading volume of a bar/candle

Example

// Find highest high in last 10 bars
const highestHigh = this.api.GetHighestValue(TValueType.HIGH, 0, 10);
console.log(`Highest high in last 10 bars: ${highestHigh}`);

// Find highest close in last 5 bars
const highestClose = this.api.GetHighestValue(TValueType.CLOSE, 0, 5);
console.log(`Highest closing price in last 5 bars: ${highestClose}`);

// Compare different value types
const highestOpen = this.api.GetHighestValue(TValueType.OPEN, 0, 3);
const highestClose = this.api.GetHighestValue(TValueType.CLOSE, 0, 3);
if (highestOpen > highestClose) {
  console.log("Highest open exceeds highest close");
}

// Find highest value in specific range
const rangeHigh = this.api.GetHighestValue(TValueType.HIGH, 5, 10);
console.log(`Highest high from bar 5 to 14: ${rangeHigh}`);