README.md

---
title: Arvanu Chronos Forecaster
emoji: 🔮
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Time-series forecasting API for market odds prediction
---

# Arvanu Chronos Forecaster

Time-series prediction API using Amazon's Chronos-Bolt model for probabilistic forecasting of market price trajectories.

## Features

- **Probabilistic Forecasts**: Returns median, 10th, and 90th percentile predictions
- **Trend Analysis**: Automatic trend detection (bullish/bearish/neutral)
- **Ensemble-Ready**: Output format compatible with Arvanu AI ensemble
- **Fast Inference**: Uses Chronos-Bolt for 250x faster predictions

## API Usage

```python
import requests

response = requests.post(
    "https://mythman-arvanu-chronos.hf.space/api/predict",
    json={
        "data": [
            "[0.52, 0.54, 0.55, 0.58, 0.56, 0.59, 0.61]",
            24  # prediction horizon
        ]
    }
)
result = response.json()
print(result)
```

## Response Format

```json
{
  "success": true,
  "forecast": {
    "median": [0.65, 0.66, 0.67, ...],
    "lower_bound": [0.62, 0.63, 0.64, ...],
    "upper_bound": [0.68, 0.69, 0.70, ...]
  },
  "analysis": {
    "trend": "bullish",
    "trend_strength": 0.65,
    "price_change_predicted": 0.05,
    "volatility": 0.08
  },
  "ensemble_output": {
    "direction": "YES",
    "confidence": 0.72,
    "model_confidence": 0.85
  }
}
```

## Part of Arvanu AI Prediction Agent

This forecaster is a component of the Arvanu Premium tier prediction ensemble, providing temporal intelligence for market odds prediction.