TradeScoutOpen the app

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

EndpointDescriptionAccess
GET /api/exportAnalytics for all covered funds, as JSON or CSV.API key
GET /api/mijnPositions and watchlists of your own account.API key
GET /openapi.jsonOpenAPI 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.

Create an API key

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

FieldDescription
formatjson (default) or csv. CSV is delivered as a file, with a dot as the decimal separator.
langLanguage 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

FieldDescription
symbolTicker in Yahoo notation, for example KO or ASML.AS.
nameFull company name.
currencyTrading currency as an ISO 4217 code.
sectorSector as reported by the data source, in English.
dividend_yield_pctDividend yield in percent, based on the current price.
risk_free_rate_pctTen-year government bond yield in the same currency: AAA-rated euro area bonds (ECB) or US Treasuries (FRED).
yield_spread_pctDividend yield minus the ten-year bond yield. A negative value means the government bond yields more.
annual_share_count_change_pctAnnual change in shares outstanding, in percent. Negative indicates buybacks, positive indicates dilution.
shareholder_yield_pctDividend 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

FieldDescription
posities[].lijstName of the portfolio list; empty for the default list.
posities[].symboolTicker in Yahoo notation.
posities[].aantalNumber of shares, or null if not entered.
posities[].aankoopprijsPurchase price per share, or null.
posities[].aankoopdatumPurchase date, or null.
volglijsten[].naamName of the watchlist.
volglijsten[].symbolenTickers on the watchlist.
bijgewerktTime 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

HTTPCodeDescription
401unauthorizedThe key is missing or invalid. The response contains no data.
429too many requestsToo many requests. Wait a moment and try again.
503not_readyThe 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