API-Referenz

Überblick

MiniValuator stellt eine REST-API bereit, mit der Sie Aktien-Fundamentaldaten programmatisch abrufen können. Es gelten dieselben Guthaben-Abrechnungsregeln — 10 Guthabenpunkte für ein neues Tickersymbol, kostenlose erneute Abfragen innerhalb von 7 Tagen.

Basis-URL: https://minivaluator.com

Authentifizierung: API-Schlüssel über den Header Authorization: Bearer sk-...

Einen API-Schlüssel erhalten

Melden Sie sich bei Ihrem MiniValuator-Konto an
Gehen Sie zu Einstellungen → API-Schlüssel
Klicken Sie auf API-Schlüssel hinzufügen, geben Sie ihm einen Namen und kopieren Sie den generierten Schlüssel (sk-...)

Bewahren Sie Ihren API-Schlüssel geheim. Jeder, der den Schlüssel besitzt, kann Ihr Guthaben verbrauchen.

Endpunkt

GET /api/stock/fundamentals

Gibt Fundamentaldaten für ein gegebenes Aktien-Tickersymbol zurück.

Anfrage

curl "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL" \
  -H "Authorization: Bearer sk-your-api-key-here"

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`symbol`	string	Ja	Aktien-Tickersymbol (z. B. `AAPL`, `MSFT`, `GOOGL`)

Antwort

{
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "fcfPerShare": 7.43,
    "currentPrice": 211.45,
    "currentPFCF": 28,
    "eps": 6.42,
    "currentPE": 33,
    "growthEstimate": {
      "rates": [0.062, 0.091, 0.08, 0.08, 0.08],
      "cagr": 0.082,
      "quality": "ok",
      "flags": []
    },
    "earningsGrowthEstimate": {
      "rates": [0.11, 0.13, 0.12, 0.12, 0.12],
      "cagr": 0.12,
      "quality": "ok",
      "flags": []
    },
    "dataSource": "Financial Modeling Prep"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`symbol`	string	Tickersymbol in Großbuchstaben
`name`	string	Unternehmensname
`fcfPerShare`	number	Freier Cashflow je Aktie (TTM, USD)
`currentPrice`	number	Aktueller Aktienkurs (USD)
`currentPFCF`	number	Kurs-zu-FCF-Multiplikator (TTM)
`eps`	number	Gewinn je Aktie (TTM, USD)
`currentPE`	number	Kurs-Gewinn-Verhältnis (TTM)
`growthEstimate`	object \| null	Umsatzbasierte 5-Jahres-Wachstumsschätzung
`earningsGrowthEstimate`	object \| null	EPS-basierte 5-Jahres-Wachstumsschätzung
`dataSource`	string	Name des Datenanbieters

growthEstimate-Felder

Feld	Typ	Beschreibung
`rates`	number[]	Fünf jährliche Wachstumsraten (Dezimalwerte, z. B. `0.08` = 8 %)
`cagr`	number	Durchschnittliche jährliche Wachstumsrate über den gesamten Zeitraum
`quality`	`"ok"` \| `"partial"` \| `"insufficient"`	Konfidenzgrad der Daten
`flags`	string[]	Hinweise zu aufgefüllten oder gekappten Werten

Fehlerantworten

HTTP-Status	Meldung	Ursache
`400`	`"Symbol required"`	Fehlender Parameter `symbol`
`400`	`"Invalid symbol format"`	Symbol enthält ungültige Zeichen
`400`	`"Insufficient credits"`	Konto hat weniger als 10 Guthabenpunkte
`400`	`"Rate limit exceeded"`	Zu viele Anfragen von dieser IP-Adresse
`400`	`"Stock not found"`	Tickersymbol vom Datenanbieter nicht erkannt

Alle Fehler folgen dem Format:

{ "error": "Insufficient credits" }

Guthabenverbrauch

Szenario	Berechnete Guthabenpunkte
Erste Abfrage für ein neues Tickersymbol	10 Guthabenpunkte
Erneute Abfrage innerhalb von 7 Tagen	Kostenlos (aus dem Cache bereitgestellt)
Erneute Abfrage nach 7 Tagen	10 Guthabenpunkte

Codebeispiele

Python

import requests

API_KEY = "sk-your-api-key-here"

response = requests.get(
    "https://minivaluator.com/api/stock/fundamentals",
    params={"symbol": "AAPL"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = response.json()
print(data["data"]["fcfPerShare"])  # 7.43

JavaScript / Node.js

const API_KEY = "sk-your-api-key-here";

const res = await fetch(
  "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { data } = await res.json();
console.log(data.fcfPerShare); // 7.43