TradeScout API
Mit der TradeScout API rufen Sie die Fondsanalysen von TradeScout sowie Ihre eigenen Positionen und Watchlists programmatisch ab. Alle Endpunkte sind schreibgeschützt und liefern JSON.
Datensatz aktualisiert am 2026-11-16 · 478 Fonds
Übersicht
Basis-URL: https://trade-scout.nl
| Endpunkt | Beschreibung | Zugriff |
|---|---|---|
GET /api/export | Analysen aller erfassten Fonds, als JSON oder CSV. | API-Schlüssel |
GET /api/mijn | Positionen und Watchlists Ihres eigenen Kontos. | API-Schlüssel |
GET /openapi.json | OpenAPI-Beschreibung der öffentlichen Leserouten. | Öffentlich |
Authentifizierung
Einen API-Schlüssel erstellen Sie unter Profil → API-Schlüssel. Der Schlüssel wird einmalig angezeigt; danach speichern wir nur einen Hash, sodass er nicht erneut abgerufen werden kann. Pro Konto sind bis zu drei Schlüssel möglich, und Sie können einen Schlüssel jederzeit widerrufen.
Authorization: Bearer <API_KEY>
Senden Sie den Schlüssel im Header Authorization, niemals in der URL. Ein Schlüssel in der URL landet in Logdateien und im Browserverlauf und wird daher abgelehnt.
Fondsanalysen
Liefert die von TradeScout berechneten Kennzahlen aller erfassten Fonds. Der Datensatz wird jede Nacht neu erstellt.
GET https://trade-scout.nl/api/export
Authorization: Bearer <API_KEY>
Parameter
| Feld | Beschreibung |
|---|---|
format | json (Standard) oder csv. CSV wird als Datei geliefert, mit Punkt als Dezimaltrennzeichen. |
lang | Sprache der lesbaren Meldungen: nl, en, de, fr oder es. |
Beispielantwort
{
"app": "tradescout-export",
"version": 2,
"built": "2026-09-04T02:31:20Z",
"notice": "…",
"count": 226,
"rows": [
{
"symbol": "KO",
"name": "Coca-Cola Company",
"currency": "USD",
"sector": "Consumer Defensive",
"dividend_yield_pct": 2.87,
"risk_free_rate_pct": 4.19,
"yield_spread_pct": -1.32,
"annual_share_count_change_pct": -0.31,
"shareholder_yield_pct": 3.18
}
]
}
Fehlende Werte sind null, niemals 0. So bleibt ein unbekannter Wert von einer tatsächlichen Null unterscheidbar.
Felder
| Feld | Beschreibung |
|---|---|
symbol | Ticker in Yahoo-Notation, zum Beispiel KO oder ASML.AS. |
name | Vollständiger Name des Unternehmens. |
currency | Handelswährung als ISO-4217-Code. |
sector | Sektor laut Datenquelle, auf Englisch. |
dividend_yield_pct | Dividendenrendite in Prozent, bezogen auf den aktuellen Kurs. |
risk_free_rate_pct | Rendite zehnjähriger Staatsanleihen in derselben Währung: AAA-Anleihen des Euroraums (EZB) oder US-Treasuries (FRED). |
yield_spread_pct | Dividendenrendite abzüglich der Zehnjahresrendite. Ein negativer Wert bedeutet, dass die Staatsanleihe mehr abwirft. |
annual_share_count_change_pct | Jährliche Veränderung der ausstehenden Aktien in Prozent. Negativ deutet auf Rückkäufe hin, positiv auf Verwässerung. |
shareholder_yield_pct | Dividendenrendite plus Netto-Rückkaufrendite: was Aktionäre jährlich zurückerhalten, ohne Kursentwicklung. |
Eigene Positionen und Watchlists
Liefert die Positionen und Watchlists des Kontos, zu dem der Schlüssel gehört, etwa für einen persönlichen KI-Assistenten. Notizen, Alerts, Budget und Journal werden nicht geteilt.
GET https://trade-scout.nl/api/mijn
Authorization: Bearer <API_KEY>
Beispielantwort
{
"app": "tradescout-mijn",
"posities": [
{
"lijst": "Dividend",
"symbool": "KO",
"aantal": 25,
"aankoopprijs": 58.4,
"aankoopdatum": "2025-03-14"
}
],
"volglijsten": [
{
"naam": "Halfgeleiders",
"symbolen": [
"ASML.AS",
"NVDA"
]
}
],
"bijgewerkt": 1790665570
}
Felder
| Feld | Beschreibung |
|---|---|
posities[].lijst | Name der Portfolioliste; leer für die Standardliste. |
posities[].symbool | Ticker in Yahoo-Notation. |
posities[].aantal | Stückzahl, oder null, wenn nicht angegeben. |
posities[].aankoopprijs | Kaufpreis pro Stück, oder null. |
posities[].aankoopdatum | Kaufdatum, oder null. |
volglijsten[].naam | Name der Watchlist. |
volglijsten[].symbolen | Ticker auf der Watchlist. |
bijgewerkt | Zeitpunkt der letzten Änderung Ihrer Daten, als Unix-Zeit in Sekunden. |
OpenAPI für KI-Assistenten
Die öffentlichen Leserouten (Kurse, Charts, Wochenberichte, Scans, Nachrichten und Fundamentaldaten) sind in einem OpenAPI-Dokument beschrieben. Fügen Sie es als Tool-Server in Open WebUI oder einem anderen Assistenten mit OpenAPI-Unterstützung hinzu. Ein Schlüssel ist nicht erforderlich; es gelten dieselben Limits wie auf der Website.
https://trade-scout.nl/openapi.json
Fehlercodes
| HTTP | Code | Beschreibung |
|---|---|---|
401 | unauthorized | Der Schlüssel fehlt oder ist ungültig. Die Antwort enthält keine Daten. |
429 | too many requests | Zu viele Anfragen. Warten Sie kurz und versuchen Sie es erneut. |
503 | not_ready | Die Daten sind vorübergehend nicht verfügbar, etwa während der nächtlichen Verarbeitung. Bitte versuchen Sie es später erneut. |
So sieht ein 401 aus
Diese Antwort geben /api/export und /api/mijn auf eine Anfrage ohne oder mit ungültigem Schlüssel, hier gesendet mit Accept-Language: de. Lassen Sie Ihr Skript auf error reagieren, nicht auf message: Dieser Text folgt der Sprache und kann umformuliert werden.
HTTP/2 401
content-type: application/json; charset=utf-8
content-language: de
www-authenticate: Bearer realm="TradeScout"
{"error": "unauthorized", "message": "Sende deinen Schlüssel als Header: Authorization: Bearer ts_…. Einen Schlüssel legst du in deinem Profil auf trade-scout.nl an.", "docs": "https://trade-scout.nl/api-docs"}
Sprache der Meldungen
Fehlercodes und die Feldnamen von /api/export sind immer englisch, damit Skripte sich darauf verlassen können. Lesbare Meldungen folgen dem Header Accept-Language oder dem Parameter lang, falls angegeben. Unterstützt werden nl, en, de, fr und es; Standard ist Englisch.
Beispiele
curl -H "Authorization: Bearer $TRADESCOUT_API_KEY" \
https://trade-scout.nl/api/export
curl -H "Authorization: Bearer $TRADESCOUT_API_KEY" \
-o funds.csv https://trade-scout.nl/api/export?format=csv
import json
import os
import urllib.request
req = urllib.request.Request(
"https://trade-scout.nl/api/export",
headers={"Authorization": f"Bearer {os.environ['TRADESCOUT_API_KEY']}"},
)
with urllib.request.urlopen(req) as resp:
data = json.load(resp)
# Fonds, deren Dividendenrendite über der Zehnjahresrendite liegt
for row in data["rows"]:
if (row["yield_spread_pct"] or 0) > 0:
print(row["symbol"], row["yield_spread_pct"])
In n8n verwenden Sie einen HTTP-Request-Node mit der Methode GET und fügen unter Headers Authorization mit dem Wert Bearer gefolgt von Ihrem Schlüssel hinzu. In Postman wählen Sie den Auth-Typ „Bearer Token“.
Einschränkungen
Die API liefert berechnete Kennzahlen, keine Rohkursdaten oder historischen Kursreihen. Diese stammen aus externen Quellen und werden nicht über die API weitergegeben.
Die API ist schreibgeschützt: Portfolios und Watchlists lassen sich über die API nicht ändern.
Pro IP-Adresse sind sechzig Anfragen pro Minute erlaubt. Die Fondsanalysen werden einmal pro Nacht aktualisiert; eine Anfrage pro Tag genügt daher.
Nutzungsbedingungen
Die Nutzung ist kostenlos, auch kommerziell, mit Quellenangabe trade-scout.nl. Die Daten sind aus öffentlichen Quellen abgeleitet und können fehlerhaft oder veraltet sein; TradeScout übernimmt keine Gewähr für ihre Richtigkeit. Nichts davon ist eine Anlageberatung.
Zu TradeScout · Alle Aktien · Alle ETFs · Über diese Plattform · Datenschutz