L’API de TradeScout

Un seul point d’accès, protégé par une clé que vous créez vous-même dans votre profil. Vous obtenez les calculs que TradeScout effectue sur des sources publiques — pas des cours revendus.

Dernière génération le 2026-09-25 · 430 fonds

Créer une clé

Connectez-vous à TradeScout, allez dans Profil → Clés API et créez-en une. La clé ne s’affiche qu’une seule fois ; ensuite le serveur n’en conserve qu’une empreinte, elle ne peut donc plus être récupérée. Trois au maximum par compte, révocables à tout moment.

Envoyez-la dans un en-tête, jamais dans l’URL : les chaînes de requête se retrouvent en clair dans les journaux du serveur.

Créer une clé dans votre profil

La requête

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

Paramètres

`format`	`json` (par défaut) ou `csv`. Le CSV est renvoyé sous forme de fichier, avec le point comme séparateur décimal.
`lang`	nl · en · de · fr · es

Langue des messages

Les noms de champs et les codes d’erreur sont toujours en anglais — c’est ce que lit un script. Les messages lisibles suivent votre en-tête Accept-Language, ou ?lang= si vous en envoyez un. Pris en charge : nl, en, de, fr, es. Sans préférence, vous obtenez l’anglais.

La réponse

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

Une valeur manquante vaut null, et non 0. Un fonds sans dépôts réglementaires n’a pas un nombre d’actions égal à zéro, et cette différence disparaît dès que quelqu’un fait un calcul avec.

Les champs

Champ	Signification
`symbol`	Symbole au format Yahoo : `KO`, `ASML.AS`.
`name`	Nom complet de l’entreprise.
`currency`	Devise de cotation, en code ISO.
`sector`	Secteur tel que la source le nomme ; en anglais.
`dividend_yield_pct`	Rendement du dividende en pourcentage, au cours actuel.
`risk_free_rate_pct`	Le taux à dix ans dans la même devise : obligations d’État AAA en euros (BCE) ou bons du Trésor américains (FRED).
`yield_spread_pct`	Rendement du dividende moins ce taux. Négatif signifie qu’une obligation d’État rapporte davantage.
`annual_share_count_change_pct`	Variation du nombre d’actions par an, en pourcentage. Négatif = rachats, positif = dilution.
`shareholder_yield_pct`	Dividende et rachats réunis : ce qu’un actionnaire récupère par an, hors variation de cours.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé absente ou inconnue. La réponse ne contient aucune donnée, pas même des totaux.
`503`	`not_ready`	La génération nocturne n’est pas terminée ou a échoué. Une liste vide passerait ici pour une réponse ; 503 est plus honnête.

Exemples

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"])

Dans n8n : un nœud HTTP Request, méthode GET, et sous Headers une ligne Authorization avec la valeur Bearer ts_…. Idem dans Postman, ou type d’authentification « Bearer Token ».

Ce qui est délibérément absent

Pas de cours bruts ni de séries historiques. Ils proviennent d’une source gratuite, et les afficher sur une page de lecture n’équivaut pas à les redistribuer via une API. Ce que vous obtenez ici, ce sont les calculs propres.

Lecture seule. Modifier votre portefeuille via l’API n’est pas encore possible : il vit dans votre navigateur, et il faut d’abord répondre à la question de ce qui se passe quand un script et un onglet écrivent en même temps.

Conditions

Libre d’utilisation, y compris commerciale, avec attribution à trade-scout.nl. Ceci ne constitue pas un conseil en investissement et l’exactitude n’est pas garantie : ce sont des chiffres dérivés de sources publiques, qui peuvent être erronés ou obsolètes. Une requête par jour suffit — les chiffres ne changent qu’une fois par nuit.

Vers TradeScout · Toutes les actions · Tous les ETF · À propos de cette plateforme · Confidentialité