# Crypto Data Source API (Dual Mode)

**Updated:** 2025-11-11T20:56:45.223511Z

This backend is designed to support **both** frontend shapes you used:
- Classic `/api/*` endpoints (status/providers/categories/charts/logs/failures/freshness/config/keys/custom/add).
- Alternate aliases and extras that some UIs expect: `/health`, `/info`, `/api/rate-limits`, `/api/alerts`, `/api/logs?type=...`,
  plus synthetic **Hugging Face** helpers under `/api/hf/*`.

## Files
- `app.py` — FastAPI application (single file, no `frontend/` folder needed). Place your `index.html` next to it if you want static SPA routing.
- `requirements.txt` — minimal, conflict-free pins tested for HF Spaces.

## Run (local)
```bash
pip install -r requirements.txt
uvicorn app:app --host 0.0.0.0 --port 7860
```

## Endpoints
- `/` → serves `index.html` if present; else JSON hint
- `/ws/live` → live events (`live_metrics`, `status_update`, `provider_status_change`, `new_alert`)
- `/health` → alias of `/api/health`
- `/info` → status-like payload
- `/api/health`
- `/api/status`
- `/api/providers`
- `/api/categories`
- `/api/charts/health-history?hours=24`
- `/api/charts/compliance?days=7`
- `/api/freshness`
- `/api/logs` (optional `?type=connection|error`)
- `/api/failures` (alias exposed also at `/api/alerts`)
- `/api/rate-limits`
- `/api/config/keys`
- `/api/custom/add` (POST query params: `name`, `url`, `category`, optional `test_field`)
- `/api/markets`, `/api/ticker/{symbol}` (via ccxt)
- `/api/hf/health`, `/api/hf/refresh` (POST), `/api/hf/registry?type=models|datasets`, `/api/hf/search?q=&kind=`, `/api/hf/run-sentiment` (POST JSON: `{"text": "..."}`)

All non-critical data are **synthetic** to keep it lightweight on Spaces.