TradeScoutOuvrir l'app

API TradeScout

L’API TradeScout donne un accès programmatique aux analyses de fonds de TradeScout ainsi qu’à vos propres positions et listes de suivi. Tous les points de terminaison sont en lecture seule et renvoient du JSON.

Jeu de données mis à jour le 2026-11-16 · 478 fonds

Vue d’ensemble

URL de base: https://trade-scout.nl

Point de terminaisonDescriptionAccès
GET /api/exportAnalyses de tous les fonds suivis, en JSON ou CSV.Clé d’API
GET /api/mijnPositions et listes de suivi de votre propre compte.Clé d’API
GET /openapi.jsonDescription OpenAPI des routes de lecture publiques.Public

Authentification

Créez une clé d’API sous Profil → Clés API. La clé n’est affichée qu’une seule fois ; nous n’en conservons ensuite qu’un hachage, si bien qu’elle ne peut plus être récupérée. Chaque compte peut disposer de trois clés au maximum, et vous pouvez révoquer une clé à tout moment.

Authorization: Bearer <API_KEY>

Transmettez la clé dans l’en-tête Authorization, jamais dans l’URL. Une clé placée dans l’URL se retrouve dans les journaux et l’historique du navigateur ; elle est donc refusée.

Créer une clé d’API

Analyses de fonds

Renvoie les indicateurs calculés par TradeScout pour tous les fonds suivis. Le jeu de données est reconstruit chaque nuit.

GET https://trade-scout.nl/api/export
Authorization: Bearer <API_KEY>

Paramètres

ChampDescription
formatjson (par défaut) ou csv. Le CSV est fourni sous forme de fichier, avec le point comme séparateur décimal.
langLangue des messages lisibles : nl, en, de, fr ou es.

Exemple de 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
    }
  ]
}

Les valeurs manquantes valent null, jamais 0, afin qu’une valeur inconnue reste distincte d’un zéro réel.

Champs

ChampDescription
symbolSymbole au format Yahoo, par exemple KO ou ASML.AS.
nameNom complet de la société.
currencyDevise de cotation, en code ISO 4217.
sectorSecteur selon la source de données, en anglais.
dividend_yield_pctRendement du dividende en pourcentage, sur la base du cours actuel.
risk_free_rate_pctRendement des obligations d’État à dix ans dans la même devise : obligations notées AAA de la zone euro (BCE) ou bons du Trésor américain (FRED).
yield_spread_pctRendement du dividende moins le rendement à dix ans. Une valeur négative signifie que l’obligation d’État rapporte davantage.
annual_share_count_change_pctVariation annuelle du nombre d’actions en circulation, en pourcentage. Une valeur négative indique des rachats, une valeur positive une dilution.
shareholder_yield_pctRendement du dividende plus rendement net des rachats : ce que les actionnaires reçoivent chaque année, hors variation de cours.

Vos positions et listes de suivi

Renvoie les positions et listes de suivi du compte auquel la clé est rattachée, par exemple pour un assistant IA personnel. Les notes, alertes, budget et journal ne sont pas partagés.

GET https://trade-scout.nl/api/mijn
Authorization: Bearer <API_KEY>

Exemple de réponse

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

Champs

ChampDescription
posities[].lijstNom de la liste de portefeuille ; vide pour la liste par défaut.
posities[].symboolSymbole au format Yahoo.
posities[].aantalNombre de titres, ou null s’il n’est pas renseigné.
posities[].aankoopprijsPrix d’achat par titre, ou null.
posities[].aankoopdatumDate d’achat, ou null.
volglijsten[].naamNom de la liste de suivi.
volglijsten[].symbolenSymboles de la liste de suivi.
bijgewerktDate de la dernière modification de vos données, en temps Unix (secondes).

OpenAPI pour les assistants IA

Les routes de lecture publiques (cours, graphiques, synthèses hebdomadaires, analyses, actualités et données fondamentales) sont décrites dans un document OpenAPI. Ajoutez-le comme serveur d’outils dans Open WebUI ou tout autre assistant compatible OpenAPI. Aucune clé n’est nécessaire ; les mêmes limites que sur le site s’appliquent.

https://trade-scout.nl/openapi.json

Codes d’erreur

HTTPCodeDescription
401unauthorizedLa clé est absente ou invalide. La réponse ne contient aucune donnée.
429too many requestsTrop de requêtes. Patientez un instant, puis réessayez.
503not_readyLes données sont temporairement indisponibles, par exemple pendant le traitement nocturne. Veuillez réessayer plus tard.

À quoi ressemble une erreur 401

Voici comment /api/export et /api/mijn répondent à une requête sans clé ou avec une clé invalide, ici envoyée avec Accept-Language: fr. Faites réagir votre script à error, pas à message : ce texte suit la langue et peut être reformulé.

HTTP/2 401
content-type: application/json; charset=utf-8
content-language: fr
www-authenticate: Bearer realm="TradeScout"

{"error": "unauthorized", "message": "Envoyez votre clé dans un en-tête : Authorization: Bearer ts_…. Vous pouvez créer une clé dans votre profil sur trade-scout.nl.", "docs": "https://trade-scout.nl/api-docs"}

Langue des messages

Les codes d’erreur et les noms de champs de /api/export sont toujours en anglais, afin que les scripts puissent s’y fier. Les messages lisibles suivent l’en-tête Accept-Language, ou le paramètre lang s’il est fourni. Langues prises en charge : nl, en, de, fr et es ; l’anglais est la langue par défaut.

Exemples

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)

# Fonds dont le rendement du dividende dépasse le rendement à dix ans
for row in data["rows"]:
    if (row["yield_spread_pct"] or 0) > 0:
        print(row["symbol"], row["yield_spread_pct"])

Dans n8n, utilisez un nœud HTTP Request avec la méthode GET et ajoutez sous Headers Authorization avec la valeur Bearer suivie de votre clé. Dans Postman, choisissez le type d’authentification « Bearer Token ».

Limites

L’API fournit des indicateurs calculés, et non des données de cours brutes ou des séries historiques. Celles-ci proviennent de sources externes et ne sont pas redistribuées via l’API.

L’API est en lecture seule : il n’est pas possible de modifier des portefeuilles ou des listes de suivi via l’API.

Chaque adresse IP peut effectuer soixante requêtes par minute. Les analyses de fonds sont mises à jour une fois par nuit ; une requête par jour suffit donc.

Conditions d’utilisation

Utilisation gratuite, y compris commerciale, avec mention de la source trade-scout.nl. Les données sont dérivées de sources publiques et peuvent être inexactes ou obsolètes ; TradeScout ne garantit pas leur exactitude. Rien de ceci ne constitue un conseil en investissement.

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