De API van TradeScout

Eén endpoint, achter een sleutel die je zelf in je profiel aanmaakt. Je krijgt het rekenwerk dat TradeScout op publieke bronnen doet — geen doorverkochte koersen.

Laatst gebouwd op 2026-09-25 · 430 fondsen

Een sleutel aanmaken

Log in op TradeScout, ga naar Profiel → API-sleutels en maak er een aan. Je ziet de sleutel één keer; daarna bewaart de server alleen nog een hash ervan, dus hij is niet meer op te vragen. Maximaal drie per account, en je kunt ze op elk moment intrekken.

Stuur hem mee als kop, nooit in de URL — querystrings belanden leesbaar in serverlogboeken.

Een sleutel aanmaken in je profiel

Het verzoek

GET https://trade-scout.nl/api/export
Authorization: Bearer ts_jouwsleutel

Parameters

`format`	`json` (standaard) of `csv`. CSV komt als bestand, met een punt als decimaalteken.
`lang`	nl · en · de · fr · es

Taal van de meldingen

Veldnamen en foutcodes zijn altijd Engels — daar leest een script op. De leesbare meldingen volgen je Accept-Language-kop, of ?lang= als je die meestuurt. Ondersteund: nl, en, de, fr, es. Zonder voorkeur is het Engels.

Het antwoord

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

Een ontbrekende waarde is null en geen 0. Een fonds zonder cijfers bij de toezichthouder heeft geen aandelental van nul, en dat verschil verdwijnt zodra iemand ermee rekent.

De velden

Veld	Betekenis
`symbol`	Ticker in Yahoo-vorm: `KO`, `ASML.AS`.
`name`	Volledige naam van het bedrijf.
`currency`	Noteringsvaluta, in ISO-code.
`sector`	Sector zoals de bron hem noemt; Engelstalig.
`dividend_yield_pct`	Dividendrendement in procenten, op de huidige koers.
`risk_free_rate_pct`	De tienjaarsrente in dezelfde munt: euro-AAA-staatsleningen (ECB) of Amerikaanse Treasuries (FRED).
`yield_spread_pct`	Dividendrendement min die rente. Negatief betekent dat een staatslening meer opbrengt.
`annual_share_count_change_pct`	Verandering van het aandelental per jaar, in procenten. Negatief is inkoop, positief is verwatering.
`shareholder_yield_pct`	Dividend plus inkoop samen: wat een aandeelhouder per jaar terugkrijgt zonder koersbeweging.

Foutmeldingen

HTTP	Code	Betekenis
`401`	`unauthorized`	Geen of onbekende sleutel. Het antwoord bevat geen enkel gegeven — ook geen aantallen.
`503`	`not_ready`	De nachtelijke bouw is nog niet klaar of mislukt. Een lege lijst zou hier als antwoord doorgaan; 503 is eerlijker.

Voorbeelden

curl -H "Authorization: Bearer ts_jouwsleutel" \
     https://trade-scout.nl/api/export

curl -H "Authorization: Bearer ts_jouwsleutel" \
     -o funds.csv https://trade-scout.nl/api/export?format=csv

import urllib.request, json

req = urllib.request.Request("https://trade-scout.nl/api/export")
req.add_header("Authorization", "Bearer ts_jouwsleutel")
data = json.load(urllib.request.urlopen(req))

# fondsen waar het dividend de tienjaarsrente verslaat
for rij in data["rows"]:
    if (rij["yield_spread_pct"] or 0) > 0:
        print(rij["symbol"], rij["yield_spread_pct"])

In n8n: een HTTP Request-node, methode GET, en onder Headers één regel Authorization met waarde Bearer ts_…. In Postman hetzelfde, of Auth type “Bearer Token”.

Wat er bewust niet in zit

Geen ruwe koersen of historische reeksen. Die komen van een gratis bron, en ze op een leespagina tonen is iets anders dan ze via een API herdistribueren. Wat je hier krijgt is het eigen rekenwerk.

Alleen lezen. Je portefeuille aanpassen via de API kan nog niet: die leeft in je browser, en er moet eerst een antwoord komen op wat er gebeurt als een script en een tabblad tegelijk schrijven.

Voorwaarden

Vrij te gebruiken, ook zakelijk, met bronvermelding naar trade-scout.nl. Geen beleggingsadvies en geen garantie op juistheid: het zijn afgeleide cijfers uit publieke bronnen, en die kunnen fout of verouderd zijn. Eén verzoek per dag is genoeg — de cijfers veranderen maar één keer per nacht.

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