README.md

---
title: NIFTY 50 Forecaster Backend
emoji: 📈
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
---

# NIFTY 50 Forecaster Backend

FastAPI Hugging Face Docker Space for the NIFTY 50 first-five-minute direction forecaster.

## Endpoints

- `GET /health`
- `GET /dashboard`
- `GET /prediction/latest`
- `POST /prediction/refresh-first5`
- `POST /data/refresh-daily`
- `GET /cron/keepalive`
- `POST /data/refresh-market-close`

## Data

Parquet files live in `data/`:

- `nifty50_1m.parquet`
- `nifty50_1d.parquet`
- `opening_direction_training_dataset.parquet`
- `test_predictions.parquet`

## Runtime

The API starts a daily background refresh loop. It wakes after `09:20 Asia/Kolkata`, fetches Yahoo Finance `^NSEI` 1-minute candles for the `09:15-09:19` opening window, appends them to Parquet, and writes the latest T+5 prediction.

After market close it wakes again at `15:45 Asia/Kolkata`, refreshes the 1-minute and daily Parquet files, updates the opening training dataset with same-day close outcomes, and writes the saved prediction record used for the next trading session card. The `/cron/keepalive` endpoint also checks this close refresh so a Hugging Face Space that was idled still catches up when Netlify pings it.

Netlify also pings `/cron/keepalive` every 10 minutes through its scheduled function.