Inferenco Predictions SDK

A Rust library for cryptocurrency price forecasting that combines statistical methods, technical analysis, and machine learning.

Features

Hybrid Forecasting Engine: Ensemble of statistical models, ML (SVR), and technical indicators
Multi-Horizon Forecasts: From 15 minutes to 4 years
Two-Tier Caching: Smart TTL-based caching for API responses and forecasts
Rate Limiting: Built-in token bucket + exponential backoff for CoinGecko API
Technical Analysis: RSI, MACD, Bollinger Bands
Local AI: On-the-fly SmartCore SVR training (no external models needed)

Installation

Add to your Cargo.toml:

[dependencies]
prediction_sdk = "0.1.0"
tokio = { version = "1", features = ["full"] }

Quick Start

cd prediction_sdk
cargo build
cargo test

Usage

use prediction_sdk::{PredictionSdk, ForecastHorizon, ShortForecastHorizon, SentimentSnapshot};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sdk = PredictionSdk::new()?;
    
    let sentiment = SentimentSnapshot {
        news_score: 0.65,
        social_score: 0.80,
    };
    
    let result = sdk.forecast_with_fetch(
        "bitcoin",
        "usd",
        ForecastHorizon::Short(ShortForecastHorizon::OneHour),
        Some(sentiment),
    ).await?;
    
    println!("Forecast: {:?}", result);
    Ok(())
}

Run the Example

cargo run --example real_world_test

Documentation

See DOCUMENTATION.md for detailed architecture, API reference, and integration guides.

CI/CD

GitHub Actions runs:

cargo fmt --check
cargo clippy
cargo build
cargo test (unit + integration + doc tests)

License

MIT

prediction_sdk 0.1.1