TradeScoutAbrir la app

API de TradeScout

La API de TradeScout ofrece acceso programático a los análisis de fondos de TradeScout y a tus propias posiciones y listas de seguimiento. Todos los endpoints son de solo lectura y devuelven JSON.

Conjunto de datos actualizado el 2026-11-16 · 478 fondos

Resumen

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

EndpointDescripciónAcceso
GET /api/exportAnálisis de todos los fondos cubiertos, en JSON o CSV.Clave de API
GET /api/mijnPosiciones y listas de seguimiento de tu propia cuenta.Clave de API
GET /openapi.jsonDescripción OpenAPI de las rutas públicas de lectura.Público

Autenticación

Crea una clave de API en Perfil → Claves API. La clave se muestra una sola vez; después solo guardamos un hash, por lo que no se puede recuperar. Cada cuenta puede tener hasta tres claves, y puedes revocar una clave en cualquier momento.

Authorization: Bearer <API_KEY>

Envía la clave en la cabecera Authorization, nunca en la URL. Una clave en la URL termina en los registros y en el historial del navegador, por lo que se rechaza.

Crear una clave de API

Análisis de fondos

Devuelve los indicadores que TradeScout calcula para todos los fondos cubiertos. El conjunto de datos se reconstruye cada noche.

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

Parámetros

CampoDescripción
formatjson (predeterminado) o csv. El CSV se entrega como archivo, con el punto como separador decimal.
langIdioma de los mensajes legibles: nl, en, de, fr o es.

Respuesta de ejemplo

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

Los valores ausentes son null, nunca 0, para que un dato desconocido siga siendo distinguible de un cero real.

Campos

CampoDescripción
symbolTicker en notación de Yahoo, por ejemplo KO o ASML.AS.
nameNombre completo de la empresa.
currencyDivisa de cotización, como código ISO 4217.
sectorSector según la fuente de datos, en inglés.
dividend_yield_pctRentabilidad por dividendo en porcentaje, según la cotización actual.
risk_free_rate_pctRendimiento de la deuda pública a diez años en la misma divisa: bonos AAA de la zona euro (BCE) o bonos del Tesoro de EE. UU. (FRED).
yield_spread_pctRentabilidad por dividendo menos el rendimiento a diez años. Un valor negativo significa que el bono del Estado rinde más.
annual_share_count_change_pctVariación anual del número de acciones en circulación, en porcentaje. Negativo indica recompras; positivo, dilución.
shareholder_yield_pctRentabilidad por dividendo más la rentabilidad neta por recompras: lo que reciben los accionistas cada año, sin contar la evolución del precio.

Tus posiciones y listas de seguimiento

Devuelve las posiciones y listas de seguimiento de la cuenta asociada a la clave, por ejemplo para un asistente de IA personal. Las notas, alertas, presupuesto y diario no se comparten.

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

Respuesta de ejemplo

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

Campos

CampoDescripción
posities[].lijstNombre de la lista de cartera; vacío para la lista predeterminada.
posities[].symboolTicker en notación de Yahoo.
posities[].aantalNúmero de acciones, o null si no se ha indicado.
posities[].aankoopprijsPrecio de compra por acción, o null.
posities[].aankoopdatumFecha de compra, o null.
volglijsten[].naamNombre de la lista de seguimiento.
volglijsten[].symbolenTickers de la lista de seguimiento.
bijgewerktMomento del último cambio en tus datos, como tiempo Unix en segundos.

OpenAPI para asistentes de IA

Las rutas públicas de lectura (cotizaciones, gráficos, resúmenes semanales, análisis, noticias y datos fundamentales) se describen en un documento OpenAPI. Añádelo como servidor de herramientas en Open WebUI o en cualquier otro asistente compatible con OpenAPI. No se necesita clave; se aplican los mismos límites que en el sitio web.

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

Códigos de error

HTTPCódigoDescripción
401unauthorizedLa clave falta o no es válida. La respuesta no contiene datos.
429too many requestsDemasiadas solicitudes. Espera un momento y vuelve a intentarlo.
503not_readyLos datos no están disponibles temporalmente, por ejemplo durante el procesamiento nocturno. Vuelve a intentarlo más tarde.

Así es un error 401

Esta es la respuesta de /api/export y /api/mijn a una solicitud sin clave o con una clave no válida, aquí enviada con Accept-Language: es. Haz que tu script compruebe error, no message: ese texto sigue el idioma y puede cambiar de redacción.

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

{"error": "unauthorized", "message": "Envía tu clave como cabecera: Authorization: Bearer ts_…. Puedes crear una clave en tu perfil en trade-scout.nl.", "docs": "https://trade-scout.nl/api-docs"}

Idioma de los mensajes

Los códigos de error y los nombres de campo de /api/export están siempre en inglés, para que los scripts puedan confiar en ellos. Los mensajes legibles siguen la cabecera Accept-Language, o el parámetro lang si se indica. Idiomas admitidos: nl, en, de, fr y es; el predeterminado es el inglés.

Ejemplos

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)

# Fondos cuya rentabilidad por dividendo supera el rendimiento a diez años
for row in data["rows"]:
    if (row["yield_spread_pct"] or 0) > 0:
        print(row["symbol"], row["yield_spread_pct"])

En n8n, usa un nodo HTTP Request con el método GET y añade en Headers Authorization con el valor Bearer seguido de tu clave. En Postman, elige el tipo de autenticación «Bearer Token».

Limitaciones

La API proporciona indicadores calculados, no datos de cotización en bruto ni series históricas. Estos proceden de fuentes externas y no se redistribuyen a través de la API.

La API es de solo lectura: no es posible modificar carteras ni listas de seguimiento a través de la API.

Cada dirección IP puede realizar sesenta solicitudes por minuto. Los análisis de fondos se actualizan una vez por noche, por lo que basta con una solicitud al día.

Condiciones de uso

Uso gratuito, también comercial, citando la fuente trade-scout.nl. Los datos se derivan de fuentes públicas y pueden ser inexactos o estar desactualizados; TradeScout no garantiza su exactitud. Nada de esto constituye asesoramiento de inversión.

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