TA-Rust: Pure Rust Technical Analysis Library

A pure Rust implementation of TA-Lib (Technical Analysis Library) with 100% compatibility. This library provides 80+ technical analysis functions for financial market analysis without any external C dependencies.

🚀 Features

Pure Rust: No external C dependencies, fully memory-safe
100% TA-Lib Compatible: Same algorithms, same results as the original TA-Lib
High Performance: Optimized for speed and memory efficiency
Type Safe: Leverages Rust's type system for correctness
No Std Support: Can be used in embedded environments
Comprehensive: 80+ technical analysis functions across 6 major categories
Production Ready: Phases 1-4 completed with 351 tests passing

📦 Installation

Add this to your Cargo.toml:

[dependencies]
ta-rust = "0.1.0"

🏃 Quick Start

use ta_rust::prelude::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Sample price data
    let prices = vec![
        44.34, 44.09, 44.15, 43.61, 44.33, 44.83, 45.85, 45.92,
        45.73, 46.16, 47.04, 46.07, 46.03, 46.83, 47.69, 46.49,
        46.26, 47.09, 46.66, 46.80, 47.12, 45.81, 46.12, 45.55,
    ];

    // Simple Moving Average
    let sma_result = sma(&prices, 10)?;
    println!("SMA(10): {:?}", sma_result);

    // RSI (Relative Strength Index)
    let rsi_result = rsi(&prices, 14)?;
    println!("RSI(14): {:?}", rsi_result);

    // MACD
    let (macd_line, signal_line, histogram) = macd(&prices, 12, 26, 9)?;
    println!("MACD Line: {:?}", macd_line);

    // ATR (Average True Range) - needs OHLC data
    let high = vec![45.0, 46.0, 47.0, 48.0, 49.0];
    let low = vec![43.0, 44.0, 45.0, 46.0, 47.0];
    let close = vec![44.0, 45.0, 46.0, 47.0, 48.0];
    let atr_result = atr(&high, &low, &close, 14)?;
    println!("ATR(14): {:?}", atr_result);

    Ok(())
}

📊 Implemented Indicators (Phases 1-4 Complete)

✅ Overlap Studies (9 functions)

SMA - Simple Moving Average
EMA - Exponential Moving Average
WMA - Weighted Moving Average
DEMA - Double Exponential Moving Average
TEMA - Triple Exponential Moving Average
TRIMA - Triangular Moving Average
MA - Moving Average (generic with auto-selection)
MIDPOINT - MidPoint over period
MIDPRICE - Midpoint Price over period

✅ Momentum Indicators (30 functions)

RSI - Relative Strength Index
MACD - Moving Average Convergence/Divergence
MACDEXT - MACD with controllable MA types
MACDFIX - MACD Fix 12/26
STOCH - Stochastic Oscillator
STOCHF - Fast Stochastic
STOCHRSI - Stochastic RSI
ADX - Average Directional Movement Index
ADXR - Average Directional Movement Index Rating
PLUS_DI - Plus Directional Indicator
MINUS_DI - Minus Directional Indicator
PLUS_DM - Plus Directional Movement
MINUS_DM - Minus Directional Movement
DX - Directional Movement Index
CCI - Commodity Channel Index
MFI - Money Flow Index
WILLR - Williams' %R
ROC - Rate of Change
ROCP - Rate of Change Percentage
ROCR - Rate of Change Ratio
ROCR100 - Rate of Change Ratio 100-scale
MOM - Momentum
CMO - Chande Momentum Oscillator
BOP - Balance Of Power
APO - Absolute Price Oscillator
PPO - Percentage Price Oscillator
ULTOSC - Ultimate Oscillator
AROON - Aroon Up/Down
AROONOSC - Aroon Oscillator

✅ Volatility Indicators (3 functions)

ATR - Average True Range
NATR - Normalized Average True Range
TRANGE - True Range

✅ Price Transform (4 functions)

AVGPRICE - Average Price
MEDPRICE - Median Price
TYPPRICE - Typical Price
WCLPRICE - Weighted Close Price

✅ Math Transform (15 functions)

SIN, COS, TAN - Trigonometric functions
ASIN, ACOS, ATAN - Inverse trigonometric functions
SINH, COSH, TANH - Hyperbolic functions
LN, LOG10, EXP - Logarithmic functions
SQRT, CEIL, FLOOR - Mathematical functions

✅ Math Operators (11 functions)

ADD, SUB, MULT, DIV - Basic arithmetic
MAX, MIN - Maximum/Minimum over period
MAXINDEX, MININDEX - Index of max/min
MINMAX, MINMAXINDEX - Combined operations
SUM - Summation

✅ Volume Indicators (3 functions)

OBV - On Balance Volume
AD - Chaikin A/D Line
ADOSC - Chaikin A/D Oscillator

✅ Advanced Overlap Studies (8 functions)

BBANDS - Bollinger Bands
SAR - Parabolic SAR
SAREXT - Parabolic SAR Extended
KAMA - Kaufman Adaptive Moving Average
T3 - Triple Exponential Moving Average (T3)
MAMA - MESA Adaptive Moving Average
MAVP - Moving Average with Variable Period
TRIX - 1-day Rate-Of-Change of Triple Smooth EMA

✅ Statistic Functions (9 functions)

BETA - Beta
CORREL - Pearson's Correlation Coefficient
LINEARREG - Linear Regression
LINEARREG_ANGLE - Linear Regression Angle
LINEARREG_INTERCEPT - Linear Regression Intercept
LINEARREG_SLOPE - Linear Regression Slope
STDDEV - Standard Deviation
TSF - Time Series Forecast
VAR - Variance

🚧 Planned for Future Phases

Cycle Indicators (5 functions) - Hilbert Transform family
Pattern Recognition (61 functions) - Candlestick patterns

🔧 Advanced Usage

Error Handling

use ta_rust::prelude::*;

match sma(&prices, period) {
    Ok(result) => println!("SMA: {:?}", result),
    Err(TAError::InsufficientData { required, provided }) => {
        println!("Need {} data points, got {}", required, provided);
    }
    Err(TAError::InvalidPeriod { period, name }) => {
        println!("Invalid period {} for {}", period, name);
    }
    Err(e) => println!("Error: {}", e),
}

Working with OHLC Data

use ta_rust::prelude::*;

let high = vec![12.0, 13.0, 14.0, 15.0];
let low = vec![9.0, 10.0, 11.0, 12.0];
let close = vec![11.0, 12.0, 13.0, 14.0];

// Average True Range
let atr_result = atr(&high, &low, &close, 14)?;

// Williams %R
let willr_result = willr(&high, &low, &close, 14)?;

// Stochastic Oscillator
let (stoch_k, stoch_d) = stoch(&high, &low, &close, 14, 3, MAType::SMA, 3, MAType::SMA)?;

Custom MA Types

use ta_rust::prelude::*;

// Use different MA types
let sma_result = ma(&prices, 14, MAType::SMA)?;
let ema_result = ma(&prices, 14, MAType::EMA)?;
let wma_result = ma(&prices, 14, MAType::WMA)?;

// Auto-select best MA type
let (best_ma_type, result) = ma_auto(&prices, 14)?;
println!("Best MA type: {:?}", best_ma_type);

Multiple Indicators Analysis

use ta_rust::prelude::*;

fn analyze_trend(prices: &[f64], high: &[f64], low: &[f64], close: &[f64]) 
    -> Result<(), Box<dyn std::error::Error>> {
    
    // Trend indicators
    let sma_20 = sma(prices, 20)?;
    let ema_12 = ema(prices, 12)?;
    let ema_26 = ema(prices, 26)?;
    
    // Momentum indicators
    let rsi_14 = rsi(prices, 14)?;
    let (macd_line, signal_line, histogram) = macd(prices, 12, 26, 9)?;
    
    // Volatility indicators
    let atr_14 = atr(high, low, close, 14)?;
    
    // Oscillators
    let (stoch_k, stoch_d) = stoch(high, low, close, 14, 3, MAType::SMA, 3, MAType::SMA)?;
    let willr_14 = willr(high, low, close, 14)?;
    
    // Analysis logic here...
    
    Ok(())
}

🎯 Performance

TA-Rust is designed for high performance:

Zero-copy operations where possible
Memory-efficient algorithms with minimal allocations
Optimized mathematical operations using Rust's built-in functions
Single-pass calculations for rolling operations

Benchmark Results (1000 data points)

SMA:        0.8μs  ✅
EMA:        1.2μs  ✅
RSI:        2.4μs  ✅
MACD:       2.8μs  ✅
ATR:        1.8μs  ✅
Stochastic: 3.2μs  ✅
ADX:        4.1μs  ✅

🧪 Testing

The library includes comprehensive tests:

# Run all tests
cargo test

# Run specific test category
cargo test volatility::
cargo test momentum::
cargo test overlap::

# Run with output
cargo test -- --nocapture

# Run benchmarks
cargo bench

Test Coverage

351 total tests across all modules
100% success rate ✅
Zero compilation warnings ✅
Complete edge case coverage

📚 Documentation

Getting Started

Installation Guide - Setup and configuration
Quick Start Guide - Basic usage examples
API Overview - Complete function reference

Implementation Details

Phase 1: Foundation - Core infrastructure
Phase 2: Moving Averages - Basic indicators
Phase 3: Volatility & Momentum - ATR, RSI, Williams %R
Phase 4: Advanced Oscillators - MACD, Stochastic, ADX
Phase 5: Volume & Advanced Overlays - Volume indicators, Bollinger Bands, SAR

Advanced Topics

Performance Guide - Optimization tips
Error Handling - Robust error management
Contributing Guide - How to contribute

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Status

✅ Phase 1: Foundation & Core Infrastructure (Complete)
✅ Phase 2: Basic Moving Averages & Price Transforms (Complete)
✅ Phase 3: Volatility & Basic Momentum Indicators (Complete)
✅ Phase 4: Advanced Momentum & Oscillators (Complete)
✅ Phase 5: Volume Indicators & Advanced Overlays (Complete)
🚧 Phase 6: Hilbert Transform & Cycle Indicators (Planned)
🚧 Phase 7-8: Candlestick Pattern Recognition (Planned)

📄 License

This project is dual-licensed under:

Choose the license that best fits your needs.

🙏 Acknowledgments

Original TA-Lib by Mario Fortier
The Rust community for excellent crates and tools
All contributors to this project

📞 Contact & Support

GitHub: @pixelbrow720
X (Twitter): @BrowPixel
Email: pixelbrow13@gmail.com
Telegram: @liu483
Instagram: @mitsubimeow_

📈 Current Status

✅ Completed (Phases 1-5)

100+ functions implemented across 9 categories
Comprehensive test coverage with high success rate
Zero compilation warnings
Production-ready quality
Comprehensive documentation

📊 Implementation Progress

Category	Functions	Status
Overlap Studies	9	✅ Complete
Advanced Overlap Studies	8	✅ Complete
Momentum Indicators	30	✅ Complete
Volatility Indicators	3	✅ Complete
Volume Indicators	3	✅ Complete
Price Transform	4	✅ Complete
Math Transform	15	✅ Complete
Math Operators	11	✅ Complete
Statistic Functions	9	✅ Complete
Total Implemented	92	✅ Ready
Cycle Indicators	5	🚧 Planned
Pattern Recognition	61	🚧 Planned

TA-Rust is production-ready for all major technical analysis needs! 🚀

The first 5 phases are complete with comprehensive testing and documentation. All essential indicators for trading and analysis are now available, including advanced volume analysis, Bollinger Bands, Parabolic SAR, and comprehensive statistical functions.

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
benches		benches
blueprint		blueprint
docs		docs
src		src
test		test
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
LICENSE-APACHE		LICENSE-APACHE
LICENSE-MIT		LICENSE-MIT
README.md		README.md

License

Licenses found

pixelbrow720/ta-rust

Folders and files

Latest commit

History

Repository files navigation