TradeScoutApp öffnen

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

EndpunktBeschreibungZugriff
GET /api/exportAnalysen aller erfassten Fonds, als JSON oder CSV.API-Schlüssel
GET /api/mijnPositionen und Watchlists Ihres eigenen Kontos.API-Schlüssel
GET /openapi.jsonOpenAPI-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.

API-Schlüssel erstellen

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

FeldBeschreibung
formatjson (Standard) oder csv. CSV wird als Datei geliefert, mit Punkt als Dezimaltrennzeichen.
langSprache 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

FeldBeschreibung
symbolTicker in Yahoo-Notation, zum Beispiel KO oder ASML.AS.
nameVollständiger Name des Unternehmens.
currencyHandelswährung als ISO-4217-Code.
sectorSektor laut Datenquelle, auf Englisch.
dividend_yield_pctDividendenrendite in Prozent, bezogen auf den aktuellen Kurs.
risk_free_rate_pctRendite zehnjähriger Staatsanleihen in derselben Währung: AAA-Anleihen des Euroraums (EZB) oder US-Treasuries (FRED).
yield_spread_pctDividendenrendite abzüglich der Zehnjahresrendite. Ein negativer Wert bedeutet, dass die Staatsanleihe mehr abwirft.
annual_share_count_change_pctJährliche Veränderung der ausstehenden Aktien in Prozent. Negativ deutet auf Rückkäufe hin, positiv auf Verwässerung.
shareholder_yield_pctDividendenrendite 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

FeldBeschreibung
posities[].lijstName der Portfolioliste; leer für die Standardliste.
posities[].symboolTicker in Yahoo-Notation.
posities[].aantalStückzahl, oder null, wenn nicht angegeben.
posities[].aankoopprijsKaufpreis pro Stück, oder null.
posities[].aankoopdatumKaufdatum, oder null.
volglijsten[].naamName der Watchlist.
volglijsten[].symbolenTicker auf der Watchlist.
bijgewerktZeitpunkt 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

HTTPCodeBeschreibung
401unauthorizedDer Schlüssel fehlt oder ist ungültig. Die Antwort enthält keine Daten.
429too many requestsZu viele Anfragen. Warten Sie kurz und versuchen Sie es erneut.
503not_readyDie 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