GetLowestValue

Finds the lowest value in a range of bars.

Syntax

GetLowestValue(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 lowest value found in the specified range.

Description

The GetLowestValue method searches for the lowest value of a specified type (Open, High, Low, Close, or Volume) 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 lowest low in last 10 bars
const lowestLow = this.api.GetLowestValue(TValueType.LOW, 0, 10);
console.log(`Lowest low in last 10 bars: ${lowestLow}`);

// Find lowest close in last 5 bars
const lowestClose = this.api.GetLowestValue(TValueType.CLOSE, 0, 5);
console.log(`Lowest closing price in last 5 bars: ${lowestClose}`);

// Compare different value types
const lowestOpen = this.api.GetLowestValue(TValueType.OPEN, 0, 3);
const lowestClose = this.api.GetLowestValue(TValueType.CLOSE, 0, 3);
if (lowestOpen < lowestClose) {
  console.log("Lowest open is below lowest close");
}

// Find lowest value in specific range
const rangeLow = this.api.GetLowestValue(TValueType.LOW, 5, 10);
console.log(`Lowest low from bar 5 to 14: ${rangeLow}`);

// Calculate price range
const high = this.api.GetHighestValue(TValueType.HIGH, 0, 5);
const low = this.api.GetLowestValue(TValueType.LOW, 0, 5);
const range = high - low;
console.log(`Price range over last 5 bars: ${range}`);