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
| Endpoint | Descripción | Acceso |
|---|---|---|
GET /api/export | Análisis de todos los fondos cubiertos, en JSON o CSV. | Clave de API |
GET /api/mijn | Posiciones y listas de seguimiento de tu propia cuenta. | Clave de API |
GET /openapi.json | Descripció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.
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
| Campo | Descripción |
|---|---|
format | json (predeterminado) o csv. El CSV se entrega como archivo, con el punto como separador decimal. |
lang | Idioma 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
| Campo | Descripción |
|---|---|
symbol | Ticker en notación de Yahoo, por ejemplo KO o ASML.AS. |
name | Nombre completo de la empresa. |
currency | Divisa de cotización, como código ISO 4217. |
sector | Sector según la fuente de datos, en inglés. |
dividend_yield_pct | Rentabilidad por dividendo en porcentaje, según la cotización actual. |
risk_free_rate_pct | Rendimiento 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_pct | Rentabilidad 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_pct | Variación anual del número de acciones en circulación, en porcentaje. Negativo indica recompras; positivo, dilución. |
shareholder_yield_pct | Rentabilidad 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
| Campo | Descripción |
|---|---|
posities[].lijst | Nombre de la lista de cartera; vacío para la lista predeterminada. |
posities[].symbool | Ticker en notación de Yahoo. |
posities[].aantal | Número de acciones, o null si no se ha indicado. |
posities[].aankoopprijs | Precio de compra por acción, o null. |
posities[].aankoopdatum | Fecha de compra, o null. |
volglijsten[].naam | Nombre de la lista de seguimiento. |
volglijsten[].symbolen | Tickers de la lista de seguimiento. |
bijgewerkt | Momento 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
| HTTP | Código | Descripción |
|---|---|---|
401 | unauthorized | La clave falta o no es válida. La respuesta no contiene datos. |
429 | too many requests | Demasiadas solicitudes. Espera un momento y vuelve a intentarlo. |
503 | not_ready | Los 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