La API de TradeScout

Un único endpoint, tras una clave que creas tú mismo en tu perfil. Obtienes los cálculos que TradeScout realiza sobre fuentes públicas, no cotizaciones revendidas.

Última generación el 2026-09-25 · 430 fondos

Crear una clave

Inicia sesión en TradeScout, ve a Perfil → Claves API y crea una. Verás la clave una sola vez; después el servidor solo guarda un hash, así que ya no se puede recuperar. Un máximo de tres por cuenta, y puedes revocarlas en cualquier momento.

Envíala como cabecera, nunca en la URL: las cadenas de consulta acaban legibles en los registros del servidor.

Crear una clave en tu perfil

La petición

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

Parámetros

`format`	`json` (por defecto) o `csv`. El CSV se entrega como archivo, con el punto como separador decimal.
`lang`	nl · en · de · fr · es

Idioma de los mensajes

Los nombres de campo y los códigos de error siempre están en inglés: es lo que lee un script. Los mensajes legibles siguen tu cabecera Accept-Language, o ?lang= si la envías. Admitidos: nl, en, de, fr, es. Sin preferencia, obtienes inglés.

La respuesta

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

Un valor ausente es null, no 0. Un fondo sin informes ante el regulador no tiene un número de acciones igual a cero, y esa diferencia desaparece en cuanto alguien calcula con ella.

Los campos

Campo	Significado
`symbol`	Símbolo en formato Yahoo: `KO`, `ASML.AS`.
`name`	Nombre completo de la empresa.
`currency`	Moneda de cotización, en código ISO.
`sector`	Sector tal como lo nombra la fuente; en inglés.
`dividend_yield_pct`	Rentabilidad por dividendo en porcentaje, al precio actual.
`risk_free_rate_pct`	El tipo a diez años en la misma moneda: deuda pública AAA en euros (BCE) o bonos del Tesoro estadounidense (FRED).
`yield_spread_pct`	Rentabilidad por dividendo menos ese tipo. Negativo significa que la deuda pública rinde más.
`annual_share_count_change_pct`	Variación del número de acciones por año, en porcentaje. Negativo son recompras, positivo es dilución.
`shareholder_yield_pct`	Dividendo más recompras: lo que un accionista recupera al año, sin contar el movimiento del precio.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	Clave ausente o desconocida. La respuesta no contiene ningún dato, ni siquiera recuentos.
`503`	`not_ready`	La generación nocturna no ha terminado o ha fallado. Una lista vacía pasaría aquí por una respuesta; 503 es más honesto.

Ejemplos

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

En n8n: un nodo HTTP Request, método GET, y en Headers una línea Authorization con el valor Bearer ts_…. Igual en Postman, o tipo de autenticación «Bearer Token».

Lo que deliberadamente no se incluye

Sin cotizaciones en bruto ni series históricas. Provienen de una fuente gratuita, y mostrarlas en una página de lectura no es lo mismo que redistribuirlas mediante una API. Lo que obtienes aquí son los cálculos propios.

Solo lectura. Modificar tu cartera mediante la API todavía no es posible: vive en tu navegador, y antes hay que responder qué ocurre cuando un script y una pestaña escriben a la vez.

Condiciones

De uso libre, también comercial, citando trade-scout.nl como fuente. No es asesoramiento de inversión ni hay garantía de exactitud: son cifras derivadas de fuentes públicas, que pueden ser erróneas o estar desactualizadas. Basta una petición al día: las cifras solo cambian una vez por noche.

A TradeScout · Todas las acciones · Todos los ETFs · Acerca de esta plataforma · Privacidad