Utility Functions
Mathematical utility functions that support technical analysis calculations. These are the building blocks used by many indicators and are also useful for custom analysis.
🛠️ When to use utilities
- Average: Quick statistical summary, smoothing data, calculating returns
- Median: Finding the "typical" value, less sensitive to outliers than mean
- Standard Deviation: Measuring volatility, risk assessment, Bollinger Bands
- Max/Min: Finding support/resistance levels, calculating ranges
Average / Mean
Calculates the arithmetic mean of a set of values
Code Example
import { getAverage } from 'trading-signals';
const values = [10, 20, 30, 40, 50];
const avg = getAverage(values);
console.log(avg); // 30
Interactive Demo
Median
Finds the middle value in a sorted dataset
Code Example
import { getMedian } from 'trading-signals';
const values = [7, 31, 47, 75, 87];
const median = getMedian(values);
console.log(median); // 47
Interactive Demo
Standard Deviation
Measures the amount of variation or dispersion in a dataset
Code Example
import { getStandardDeviation } from 'trading-signals';
const values = [10, 12, 14, 16, 18];
const stdDev = getStandardDeviation(values);
console.log(stdDev);
Interactive Demo
Maximum & Minimum
Finds the highest and lowest values in a dataset
Code Example
import { getMaximum, getMinimum } from 'trading-signals';
const values = [25, 50, 75, 100, 125];
console.log(getMaximum(values)); // 125
console.log(getMinimum(values)); // 25
Interactive Demo
Other Utility Functions
getQuartile
Calculates Q1, Q2 (median), and Q3 values for a dataset
getGrid
Generates price grid levels for grid trading strategies
getStreaks
Identifies consecutive positive/negative value sequences
getWeekday
Extracts weekday information from timestamps
⚠️ Important Disclaimer
Signals by technical trading indicators are not guarantees. Always use proper risk management, confirm signals with multiple indicators, and never rely on a single indicator for trading decisions. This library is for educational purposes and does not constitute financial advice.