TradeScout API
The TradeScout API gives programmatic access to TradeScout's fund analytics and to your own positions and watchlists. All endpoints are read-only and return JSON.
Dataset updated on 2026-11-16 · 478 funds
Overview
Base URL: https://trade-scout.nl
| Endpoint | Description | Access |
|---|---|---|
GET /api/export | Analytics for all covered funds, as JSON or CSV. | API key |
GET /api/mijn | Positions and watchlists of your own account. | API key |
GET /openapi.json | OpenAPI description of the public read routes. | Public |
Authentication
Create an API key under Profile → API keys. The key is shown once; after that we only store a hash, so it cannot be retrieved again. Each account can have up to three keys, and you can revoke a key at any time.
Authorization: Bearer <API_KEY>
Send the key in the Authorization header, never in the URL. A key in the URL ends up in log files and browser history, and is therefore rejected.
Fund analytics
Returns the metrics TradeScout calculates for all covered funds. The dataset is rebuilt every night.
GET https://trade-scout.nl/api/export
Authorization: Bearer <API_KEY>
Parameters
| Field | Description |
|---|---|
format | json (default) or csv. CSV is delivered as a file, with a dot as the decimal separator. |
lang | Language of human-readable messages: nl, en, de, fr or es. |
Example response
{
"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
}
]
}
Missing values are null, never 0, so an unknown value remains distinguishable from an actual zero.
Fields
| Field | Description |
|---|---|
symbol | Ticker in Yahoo notation, for example KO or ASML.AS. |
name | Full company name. |
currency | Trading currency as an ISO 4217 code. |
sector | Sector as reported by the data source, in English. |
dividend_yield_pct | Dividend yield in percent, based on the current price. |
risk_free_rate_pct | Ten-year government bond yield in the same currency: AAA-rated euro area bonds (ECB) or US Treasuries (FRED). |
yield_spread_pct | Dividend yield minus the ten-year bond yield. A negative value means the government bond yields more. |
annual_share_count_change_pct | Annual change in shares outstanding, in percent. Negative indicates buybacks, positive indicates dilution. |
shareholder_yield_pct | Dividend yield plus net buyback yield: what shareholders receive each year, excluding price changes. |
Your positions and watchlists
Returns the positions and watchlists of the account the key belongs to, for example for a personal AI assistant. Notes, alerts, budget and journal are not shared.
GET https://trade-scout.nl/api/mijn
Authorization: Bearer <API_KEY>
Example response
{
"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
}
Fields
| Field | Description |
|---|---|
posities[].lijst | Name of the portfolio list; empty for the default list. |
posities[].symbool | Ticker in Yahoo notation. |
posities[].aantal | Number of shares, or null if not entered. |
posities[].aankoopprijs | Purchase price per share, or null. |
posities[].aankoopdatum | Purchase date, or null. |
volglijsten[].naam | Name of the watchlist. |
volglijsten[].symbolen | Tickers on the watchlist. |
bijgewerkt | Time of the last change to your data, as Unix time in seconds. |
OpenAPI for AI assistants
The public read routes (quotes, charts, weekly briefs, scans, news and fundamentals) are described in an OpenAPI document. Add it as a tool server in Open WebUI or any other assistant that supports OpenAPI. No key is required; the same limits as on the website apply.
https://trade-scout.nl/openapi.json
Error codes
| HTTP | Code | Description |
|---|---|---|
401 | unauthorized | The key is missing or invalid. The response contains no data. |
429 | too many requests | Too many requests. Wait a moment and try again. |
503 | not_ready | The data is temporarily unavailable, for example during nightly processing. Please try again later. |
What a 401 looks like
This is how /api/export and /api/mijn respond to a request with a missing or invalid key, here sent with Accept-Language: en. Have your script check error, not message: that text follows the language and may be reworded.
HTTP/2 401
content-type: application/json; charset=utf-8
content-language: en
www-authenticate: Bearer realm="TradeScout"
{"error": "unauthorized", "message": "Send your key as a header: Authorization: Bearer ts_…. You can create a key in your profile on trade-scout.nl.", "docs": "https://trade-scout.nl/api-docs"}
Message language
Error codes and the field names of /api/export are always in English, so scripts can rely on them. Human-readable messages follow the Accept-Language header, or the lang parameter if provided. Supported: nl, en, de, fr and es; the default is English.
Examples
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)
# Funds whose dividend yield exceeds the ten-year bond yield
for row in data["rows"]:
if (row["yield_spread_pct"] or 0) > 0:
print(row["symbol"], row["yield_spread_pct"])
In n8n, use an HTTP Request node with method GET and add Authorization under Headers, with the value Bearer followed by your key. In Postman, choose the auth type “Bearer Token”.
Limitations
The API provides calculated metrics, not raw market data or historical price series. Those come from external sources and are not redistributed through the API.
The API is read-only: portfolios and watchlists cannot be changed through the API.
Each IP address may make sixty requests per minute. Fund analytics are updated once a night, so one request per day is sufficient.
Terms of use
Free to use, including commercially, with attribution to trade-scout.nl. The data is derived from public sources and may be inaccurate or out of date; TradeScout gives no warranty of accuracy. Nothing here is investment advice.
To TradeScout · All stocks · All ETFs · About this platform · Privacy