TradeScoutOpen de app

TradeScout API

Met de TradeScout API haal je de fondsanalyses van TradeScout en je eigen posities en volglijsten programmatisch op. Alle endpoints zijn alleen-lezen en geven JSON terug.

Dataset bijgewerkt op 2026-11-16 · 478 fondsen

Overzicht

Basis-URL: https://trade-scout.nl

EndpointOmschrijvingToegang
GET /api/exportFondsanalyses van alle gevolgde fondsen, als JSON of CSV.API-sleutel
GET /api/mijnPosities en volglijsten van je eigen account.API-sleutel
GET /openapi.jsonOpenAPI-beschrijving van de openbare leesroutes.Openbaar

Authenticatie

Je maakt een API-sleutel aan via Profiel → API-sleutels. De sleutel wordt eenmalig getoond; daarna bewaren we alleen een hash, zodat hij niet opnieuw kan worden opgevraagd. Per account zijn maximaal drie sleutels mogelijk, en je kunt een sleutel op elk moment intrekken.

Authorization: Bearer <API_KEY>

Stuur de sleutel mee in de header Authorization, nooit in de URL. Een sleutel in de URL komt terecht in logbestanden en browsergeschiedenis en wordt daarom geweigerd.

API-sleutel aanmaken

Fondsanalyses

Geeft de door TradeScout berekende kengetallen van alle gevolgde fondsen terug. De dataset wordt elke nacht opnieuw opgebouwd.

GET https://trade-scout.nl/api/export
Authorization: Bearer <API_KEY>

Parameters

VeldOmschrijving
formatjson (standaard) of csv. CSV wordt als bestand geleverd, met een punt als decimaalteken.
langTaal van de leesbare meldingen: nl, en, de, fr of es.

Voorbeeldantwoord

{
  "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
    }
  ]
}

Ontbrekende waarden zijn null, nooit 0. Zo blijft een onbekend gegeven te onderscheiden van een werkelijke nulwaarde.

Velden

VeldOmschrijving
symbolTicker in Yahoo-notatie, bijvoorbeeld KO of ASML.AS.
nameVolledige naam van de onderneming.
currencyNoteringsvaluta als ISO 4217-code.
sectorSector volgens de databron, in het Engels.
dividend_yield_pctDividendrendement in procenten, op basis van de actuele koers.
risk_free_rate_pctRente op tienjaars staatsobligaties in dezelfde valuta: AAA-staatsobligaties uit de eurozone (ECB) of Amerikaanse Treasuries (FRED).
yield_spread_pctDividendrendement minus de tienjaarsrente. Een negatieve waarde betekent dat de staatsobligatie meer oplevert.
annual_share_count_change_pctJaarlijkse verandering van het aantal uitstaande aandelen, in procenten. Negatief duidt op inkoop, positief op verwatering.
shareholder_yield_pctDividendrendement plus netto inkooprendement: wat aandeelhouders jaarlijks terugkrijgen, exclusief koersontwikkeling.

Eigen posities en volglijsten

Geeft de posities en volglijsten terug van het account waaraan de sleutel gekoppeld is, bijvoorbeeld voor een persoonlijke AI-assistent. Notities, alerts, budget en journaal worden niet gedeeld.

GET https://trade-scout.nl/api/mijn
Authorization: Bearer <API_KEY>

Voorbeeldantwoord

{
  "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
}

Velden

VeldOmschrijving
posities[].lijstNaam van de portefeuillelijst; leeg voor de standaardlijst.
posities[].symboolTicker in Yahoo-notatie.
posities[].aantalAantal stuks, of null als dat niet is ingevuld.
posities[].aankoopprijsAankoopprijs per stuk, of null.
posities[].aankoopdatumAankoopdatum, of null.
volglijsten[].naamNaam van de volglijst.
volglijsten[].symbolenTickers op de volglijst.
bijgewerktTijdstip van de laatste wijziging van je gegevens, als Unix-tijd in seconden.

OpenAPI voor AI-assistenten

De openbare leesroutes (koersen, grafieken, weekbeelden, scans, nieuws en fundamentele gegevens) zijn beschreven in een OpenAPI-document. Voeg het toe als tool-server in Open WebUI of een andere assistent die OpenAPI ondersteunt. Hiervoor is geen sleutel nodig; dezelfde limieten als op de website zijn van toepassing.

https://trade-scout.nl/openapi.json

Foutcodes

HTTPCodeOmschrijving
401unauthorizedDe sleutel ontbreekt of is ongeldig. Het antwoord bevat geen gegevens.
429too many requestsTe veel verzoeken. Wacht even en probeer het opnieuw.
503not_readyDe gegevens zijn tijdelijk niet beschikbaar, bijvoorbeeld tijdens de nachtelijke verwerking. Probeer het later opnieuw.

Zo ziet een 401 eruit

Dit antwoord geven /api/export en /api/mijn op een verzoek zonder sleutel of met een ongeldige sleutel, hier met Accept-Language: nl. Laat je script reageren op error en niet op message: die tekst volgt de taal en kan anders geformuleerd worden.

HTTP/2 401
content-type: application/json; charset=utf-8
content-language: nl
www-authenticate: Bearer realm="TradeScout"

{"error": "unauthorized", "message": "Stuur je sleutel mee als kop: Authorization: Bearer ts_…. Een sleutel maak je aan in je profiel op trade-scout.nl.", "docs": "https://trade-scout.nl/api-docs"}

Taal van meldingen

Foutcodes en de veldnamen van /api/export zijn altijd Engels, zodat scripts er betrouwbaar op kunnen reageren. Leesbare meldingen volgen de header Accept-Language, of de parameter lang als die is meegegeven. Ondersteund zijn nl, en, de, fr en es; standaard is Engels.

Voorbeelden

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)

# Fondsen waarvan het dividendrendement hoger is dan de tienjaarsrente
for row in data["rows"]:
    if (row["yield_spread_pct"] or 0) > 0:
        print(row["symbol"], row["yield_spread_pct"])

In n8n gebruik je een HTTP Request-node met methode GET en voeg je onder Headers Authorization toe met de waarde Bearer gevolgd door je sleutel. In Postman kies je het Auth-type “Bearer Token”.

Beperkingen

De API levert berekende kengetallen, geen ruwe koersdata of historische reeksen. Die zijn afkomstig van externe bronnen en worden niet via de API doorgegeven.

De API is alleen-lezen: portefeuilles en volglijsten wijzigen via de API is niet mogelijk.

Per IP-adres zijn zestig verzoeken per minuut toegestaan. De fondsanalyses worden eenmaal per nacht bijgewerkt; één verzoek per dag is daarom voldoende.

Gebruiksvoorwaarden

Gebruik is kosteloos toegestaan, ook commercieel, met bronvermelding naar trade-scout.nl. De gegevens zijn afgeleid uit openbare bronnen en kunnen onjuist of verouderd zijn; TradeScout geeft geen garantie op juistheid. Niets hiervan is beleggingsadvies.

Naar TradeScout · Alle fondsen · Alle ETF's · Over dit platform · Privacy