API-Endpunkte Fundamentalanalyse
ID: REQ-FA-005 · Service: fundamental-analysis · Status: 🟢 aktiv · Use Case: UC-FA-002, UC-FA-003, UC-FA-004, UC-FA-005
FastAPI-Endpunkte für den Fundamental Analysis Service, integriert in den bestehenden trend-analysis Container (Port 8002). Alle Endpunkte sind read-only und lesen aus market_data.economic_indicators und market_data.correlation_data.
Endpoints
Eintrag 1
Methode: GET
Path: /api/v1/fundamental/indicators
Parameter
| Pair |
|---|
| string (z.B. "EUR/USD") |
Beschreibung
Liefert die aktuellen Makroindikatoren für beide Währungsseiten des Paares mit Interpretation und Teilscore pro Indikator.
Antwort
Base Currency
| Feld | Wert |
|---|---|
| Region | string |
| Score | float |
| Indikatoren | list of |
Quote Currency: gleiche Struktur wie base_currency
Disclaimer: string
Eintrag 2
Methode: GET
Path: /api/v1/fundamental/sentiment
Parameter
| Pair |
|---|
| string |
Beschreibung
Liefert Rohstoff-Korrelationen, Risikosentiment (VIX, SPX) und Geopolitik-/Unsicherheitsindizes für das gewählte Paar.
Antwort
Risk Sentiment
Vix
| Feld | Wert |
|---|---|
Spx
| Feld | Wert |
|---|---|
Hy Spread
| Feld | Wert |
|---|---|
Commodity Correlations: list of {instrument, price, pair_signal, interpretation}
Geopolitical
Gpr
| Feld | Wert |
|---|---|
Epu Base
| Feld | Wert |
|---|---|
Epu Quote
| Feld | Wert |
|---|---|
Overall Sentiment Score: float
Disclaimer: string
Eintrag 3
Methode: GET
Path: /api/v1/fundamental/score
Parameter
| Pair |
|---|
| string |
Beschreibung: Liefert den gewichteten Gesamtscore (Macro + Sentiment + Geopolitik) für das gewählte Währungspaar.
Performance
| Feld | Wert |
|---|---|
| Target Response Time | < 500ms |
| Hinweis | Alle Berechnungen erfolgen direkt aus DB-Daten, kein externer API-Call zur Request-Zeit |
Abnahmekriterien
- [ ] Alle drei Endpunkte antworten mit korrektem JSON
- [ ] Ungültige Währungspaare geben HTTP 400 mit verständlicher Fehlermeldung
- [ ] Endpunkte sind ohne Authentifizierung erreichbar (Cloudflare Access als Schutzschicht)
- [ ] Response-Zeit liegt unter 500ms auch auf dem Raspberry Pi
- [ ] Alle Endpunkte sind in /health des trend-analysis Containers referenziert
Changelog
Eintrag 1
Version: 1.0
Changes: Initiale Version