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
| Endpoint | Omschrijving | Toegang |
|---|---|---|
GET /api/export | Fondsanalyses van alle gevolgde fondsen, als JSON of CSV. | API-sleutel |
GET /api/mijn | Posities en volglijsten van je eigen account. | API-sleutel |
GET /openapi.json | OpenAPI-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.
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
| Veld | Omschrijving |
|---|---|
format | json (standaard) of csv. CSV wordt als bestand geleverd, met een punt als decimaalteken. |
lang | Taal 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
| Veld | Omschrijving |
|---|---|
symbol | Ticker in Yahoo-notatie, bijvoorbeeld KO of ASML.AS. |
name | Volledige naam van de onderneming. |
currency | Noteringsvaluta als ISO 4217-code. |
sector | Sector volgens de databron, in het Engels. |
dividend_yield_pct | Dividendrendement in procenten, op basis van de actuele koers. |
risk_free_rate_pct | Rente op tienjaars staatsobligaties in dezelfde valuta: AAA-staatsobligaties uit de eurozone (ECB) of Amerikaanse Treasuries (FRED). |
yield_spread_pct | Dividendrendement minus de tienjaarsrente. Een negatieve waarde betekent dat de staatsobligatie meer oplevert. |
annual_share_count_change_pct | Jaarlijkse verandering van het aantal uitstaande aandelen, in procenten. Negatief duidt op inkoop, positief op verwatering. |
shareholder_yield_pct | Dividendrendement 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
| Veld | Omschrijving |
|---|---|
posities[].lijst | Naam van de portefeuillelijst; leeg voor de standaardlijst. |
posities[].symbool | Ticker in Yahoo-notatie. |
posities[].aantal | Aantal stuks, of null als dat niet is ingevuld. |
posities[].aankoopprijs | Aankoopprijs per stuk, of null. |
posities[].aankoopdatum | Aankoopdatum, of null. |
volglijsten[].naam | Naam van de volglijst. |
volglijsten[].symbolen | Tickers op de volglijst. |
bijgewerkt | Tijdstip 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
| HTTP | Code | Omschrijving |
|---|---|---|
401 | unauthorized | De sleutel ontbreekt of is ongeldig. Het antwoord bevat geen gegevens. |
429 | too many requests | Te veel verzoeken. Wacht even en probeer het opnieuw. |
503 | not_ready | De 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