NyxsOwl

<div align="center"> <img src="https://raw.githubusercontent.com/rustic-ml/NyxsOwl/main/IMG_2167_250px.jpg" alt="NyxsOwl Project Image" width="250"/> </div>

Production-ready financial analysis library for Rust

NyxsOwl provides institutional-grade tools for quantitative finance, technical analysis, and algorithmic trading. Built for performance, reliability, and ease of use.

Named after Nyx (Greek goddess of night, strategic advantage) and Bubo (wise owl, wisdom in darkness) - embodying the essence of strategic financial analysis through wisdom, patience, and precision.

Quick Start

Add to your Cargo.toml:

[dependencies]
nyxs_owl = "0.7.3"

Core Features

📊 Technical Analysis

Production-ready indicators with comprehensive test coverage (125/125 unit tests passing + memory optimized)

use nyxs_owl::trade_math::*;

let mut rsi = oscillators::RelativeStrengthIndex::new(14)?;
let mut bb = volatility::BollingerBands::new(20, 2.0)?;

for price in prices {
    rsi.update(price)?;
    println!("RSI: {:.2}", rsi.value()?);
}

🔮 Time Series Forecasting

Advanced forecasting with multiple model support (Enhanced with latest dependencies)

use nyxs_owl::forecast_trade::easy::*;

let (forecast, model) = auto_forecast(timestamps, values, 10)?;
println!("Best model: {} | Forecast: {:?}", model, forecast);

⚡ Strategy Backtesting

Memory-optimized, high-performance backtesting engine with Polars 0.47.x

use nyxs_owl::strategy_lib::backtest::*;

let config = BacktestConfig {
    initial_capital: 100_000.0,
    commission: 0.001,
    slippage: 0.0005,
    position_size: 1.0,
};

let results = run_backtest(&data, &signals, &config)?;
println!("Sharpe Ratio: {:.2}", results.sharpe_ratio);

API Overview

Technical Indicators

• Moving Averages: SMA, EMA, VWMA
• Volatility: Bollinger Bands, ATR, Standard Deviation
• Oscillators: RSI, MACD, Stochastic
• Volume: OBV, Volume Profile, VROC

Forecasting Models (Memory Optimized v0.7.3)

• Enhanced ARIMA: Autoregressive models with adaptive order selection and regime detection
• Adaptive Ensemble: Dynamic model weighting with performance-based adaptation
• Exponential Smoothing: Simple and double exponential with adaptive parameters
• Moving Average: Various window forecasting with outlier detection
• Auto Selection: Intelligent model selection with quality monitoring
• Memory Optimized: All models use efficient memory management and Polars 0.47.x

Strategy Framework

• Signal Generation: Buy/Sell/Hold signal framework
• Risk Management: Position sizing and stop losses
• Performance Analytics: Sharpe ratio, max drawdown, win rate
• Backtesting: Historical strategy validation

Examples

Basic Technical Analysis

use nyxs_owl::trade_math::{moving_averages::*, oscillators::*};

fn analyze_stock(prices: &[f64]) -> Result<(), Box<dyn std::error::Error>> {
    let mut sma = SimpleMovingAverage::new(20)?;
    let mut rsi = RelativeStrengthIndex::new(14)?;
    
    for &price in prices {
        sma.update(price)?;
        rsi.update(price)?;
        
        let signal = match rsi.value()? {
            x if x > 70.0 => "SELL - Overbought",
            x if x < 30.0 => "BUY - Oversold", 
            _ => "HOLD"
        };
        
        println!("Price: {:.2} | SMA: {:.2} | RSI: {:.2} | Signal: {}", 
                price, sma.value()?, rsi.value()?, signal);
    }
    Ok(())
}

Advanced Forecasting

use nyxs_owl::forecast_trade::easy::*;
use chrono::{DateTime, Utc, Duration};

fn forecast_prices() -> Result<(), Box<dyn std::error::Error>> {
    // Generate sample data
    let now = Utc::now();
    let timestamps: Vec<DateTime<Utc>> = (0..30)
        .map(|i| now - Duration::days(30 - i))
        .collect();
    let prices: Vec<f64> = (0..30)
        .map(|i| 100.0 + i as f64 + (i as f64 * 0.1).sin() * 5.0)
        .collect();
    
    // Auto-select best model and forecast
    let (forecast, model_name) = auto_forecast(timestamps, prices, 5)?;
    
    println!("Selected model: {}", model_name);
    println!("5-day forecast: {:?}", forecast);
    
    // Compare multiple models
    let ma_forecast = forecast_moving_average(&prices, 5, 5)?;
    let es_forecast = forecast_exponential_smoothing(&prices, 0.3, 5)?;
    let arima_forecast = forecast_arima(&prices, (1, 1, 1), 5)?;
    
    println!("Moving Average: {:?}", ma_forecast);
    println!("Exp Smoothing: {:?}", es_forecast);  
    println!("ARIMA: {:?}", arima_forecast);
    
    Ok(())
}

Strategy Backtesting

use nyxs_owl::strategy_lib::backtest::*;
use polars::prelude::*;

fn backtest_strategy() -> Result<(), Box<dyn std::error::Error>> {
    // Load market data (OHLCV format)
    let data = df! {
        "timestamp" => [1, 2, 3, 4, 5],
        "open" => [100.0, 101.0, 102.0, 101.5, 103.0],
        "high" => [101.0, 102.5, 103.0, 102.0, 104.0],
        "low" => [99.5, 100.5, 101.0, 100.5, 102.0],
        "close" => [100.5, 102.0, 101.5, 103.0, 103.5],
        "volume" => [1000, 1500, 1200, 1800, 1600],
    }?;
    
    // Generate signals (1 = Buy, -1 = Sell, 0 = Hold)
    let signals = Series::new("signal".into(), [1, 0, -1, 0, 1]);
    
    // Configure backtest
    let config = BacktestConfig {
        initial_capital: 100_000.0,
        commission: 0.001,        // 0.1% commission
        slippage: 0.0005,        // 0.05% slippage
        position_size: 1.0,      // 100% of capital
    };
    
    // Run backtest
    let results = run_backtest(&data, &signals, &config)?;
    
    // Display results
    println!("=== Backtest Results ===");
    println!("Total Return: {:.2}%", results.total_return * 100.0);
    println!("Sharpe Ratio: {:.2}", results.sharpe_ratio);
    println!("Max Drawdown: {:.2}%", results.max_drawdown * 100.0);
    println!("Win Rate: {:.2}%", results.win_rate * 100.0);
    println!("Total Trades: {}", results.total_trades);
    
    Ok(())
}

Feature Flags

Control what you include:

[dependencies]
# Minimal - just technical indicators
nyxs_owl = { version = "0.7.3", default-features = false, features = ["trading-math"] }

# With forecasting
nyxs_owl = { version = "0.7.3", features = ["trading-math", "forecasting"] }

# Full features
nyxs_owl = { version = "0.7.3", features = ["all"] }

Performance

NyxsOwl is built for production environments:

• Memory Efficient: Streaming calculations, minimal allocation
• Fast: Optimized algorithms with SIMD support where applicable
• Reliable: 240+ unit tests passing with comprehensive edge case testing
• Concurrent: Thread-safe design for parallel processing
• Modern Dependencies: Built with latest Rust ecosystem (Polars 0.47.x, thiserror 2.0)

Latest Updates (v0.7.2)

• Major Dependency Updates: All dependencies updated to latest versions
• Enhanced Performance: Polars 0.47.x brings significant speed improvements
• Improved Error Handling: Updated to thiserror 2.0 for better error messages
• Better Statistics: Updated statrs to 0.17.x for enhanced mathematical functions
• Testing Improvements: Updated testing framework with rstest 0.23 and proptest 1.7

Getting Help

• Documentation: docs.rs/nyxs_owl
• Examples: See examples/ directory
• Issues: GitHub Issues

License

Licensed under either of:

• MIT License (LICENSE-MIT)
• Apache License, Version 2.0 (LICENSE-APACHE)

at your option.