Una API de operaciones de directivos que cubre 46 mercados (AMF · SEC · BaFin · SIX SER · RNS · SEDI · Consob · CNMV · AFM · FSMA · Oslo · Helsinki · Copenhagen · ASX · FMA · CVM · HKEX · BSE-Sofia · Tadawul · DART · EDINET · SSE · SZSE · SEBI · KNF · PSE · NZX · JSE) en un esquema único. Importes normalizados en EUR/USD. Backtests minoristas T+30/T+90/T+365 incluidos. Scoring transparente (7 factores desglosables). Nativa para IA: servidor MCP para Claude, Cursor, Windsurf. API en los planes Pro y Quant.
Acceso a la API · beta privada Insiders Trades está en beta privada. La API y el servidor MCP se desbloquean con los planes Pro y Quant. Únete a la lista de espera para obtener acceso anticipado (334 solicitudes/día, 5 años de historial en la API, MCP, alertas por email).
X-Api-Key: <key> · alternativa si tu cliente HTTP no gestiona bien la cabecera Authorization.
La clave se muestra una sola vez al crearla. Si la pierdes, revócala y genera una nueva. Límite: 10 claves activas por cuenta. Las claves revocadas siguen visibles en el historial.
Formato de las claves
text
sit_live_<32 caracteres base62>
Ejemplo de prefijo visible (seguro para logs): sit_live_Ab1C
La clave completa tiene unos 40 caracteres. Se almacena con hash (SHA-256) en el servidor
y nunca se puede recuperar en texto plano.
Clave no válida, caducada o revocada
Cualquier error de autenticación devuelve un HTTP 401 con un formato uniforme:
json
{
"error": {
"code": "invalid_api_key",
"message": "Clave API no válida, desconocida o revocada. Genera una nueva clave desde tu cuenta.",
"status": 401
}
}
Fundamentos
Conceptos clave
URL base
text
https://insiders-trades.com
Metadatos universales
Cada respuesta 200 incluye un objeto meta. Contiene la latencia del servidor y un pequeño diccionario dataFreshness con la fecha de última actualización de cada bloque de datos, para que tu cliente decida si debe invalidar su caché.
Los endpoints de listado admiten ?limit (por defecto 50, máx. 200) y ?offset (por defecto 0). El campo total devuelto permite paginar hasta el final.
Formato de las marcas de tiempo
Todas las marcas de tiempo están en ISO 8601 UTC (2026-04-20T18:32:11.123Z).
Campos que admiten null
Un campo ausente en la base de datos se serializa como null (nunca se omite). Así puedes distinguir entre "dato ausente" y un error de campo.
BigInt (importes)
Campos como marketCap, revenue, totalAmount pueden superar la capacidad de los números de coma flotante de JS (253). Se devuelven como números, pero para totales grandes (L'Oréal con 195 000 M€…) tu código cliente debe usar BigInt si la precisión importa por debajo de 1 €.
Referencia de la API
Endpoints
Todos los endpoints son de solo lectura, agrupados por dominio. Filtro multimercado con ?market=<code> en todos los endpoints de listado (códigos listados por GET /v1/markets).
── Autenticación
GET/api/v1/me
Verificar una clave y obtener la identidad
Devuelve la información del propietario de la clave y los metadatos de la propia clave. Úsalo como ping para comprobar que una clave sigue activa.
Hace ping a la base de datos (con latencia medida) y fecha cada etapa del pipeline. Útil para detectar que el cron horario o el scoring se han detenido.
Catálogo de los reguladores ingeridos con contadores en vivo (declaraciones, empresas) y ventana de cobertura por mercado. Llámalo una vez al iniciar tu integración para comprobar qué está disponible.
Devuelve el perfil completo: cuenta de resultados, balance, valoración (P/E, P/B, beta), consenso de analistas (reco, objetivo medio/alto/bajo) e indicadores técnicos (52 semanas, medias de 50/200 días, rentabilidad por dividendo).
Parámetros de ruta
Nombre
Tipo
Por defecto
Descripción
slugobligatorio
string
·
Identificador URL único de la empresa (presente en la lista)
Compras netas menos ventas netas en una empresa, agrupadas por mes (o semana ISO), con agregados por directivo y una señal móvil de 90 días. Pensado para detectar fases de acumulación o distribución.
Transacciones ordenadas en el tiempo para un directivo, con un volumen acumulado por empresa recalculado en cada línea, para ver cómo se construye la posición operación a operación.
Alias de from. Combínalo con sort=pubDate&order=asc para polling incremental.
include
string
·
Lista CSV de objetos relacionados que se incluyen en línea. Admitido: backtest
from
ISO date
·
Filtro pubDate >= from
to
ISO date
·
Filtro pubDate <= to
minScore
number
·
Umbral mínimo de signalScore
maxScore
number
·
Umbral máximo de signalScore
direction
enum
·
BUY | SELL
cluster
boolean
·
true = solo operaciones en clúster
minAmount
number
·
Importe mínimo en €
company
string
·
Búsqueda por nombre de empresa
insider
string
·
Búsqueda por nombre de directivo
isin
string
·
Filtro exacto por ISIN
sort
enum
pubDate
pubDate | signalScore | amount
order
enum
desc
asc | desc
limit
integer
50
1 → 200
offset
integer
0
Desplazamiento de paginación
bash
# Top 20 señales de compra con score v3 ≥ 50 en los últimos 30 días
curl "https://insiders-trades.com/api/v1/declarations?direction=BUY&minScore=50&from=2026-03-20&sort=signalScore&order=desc&limit=20" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
Variantes multimercado
bash
# Solo compras en EE. UU., importes en EUR, con backtest incluido
curl "https://insiders-trades.com/api/v1/declarations?market=us&direction=BUY¤cy=EUR&include=backtest&limit=20" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
# Polling incremental, todas las declaraciones nuevas desde ayer, orden asc
curl "https://insiders-trades.com/api/v1/declarations?since=2026-05-16&sort=pubDate&order=asc&limit=200" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
# Compras en clúster DE+CH (Vorstand alemán + consejo suizo) por encima de 500 000 EUR
curl "https://insiders-trades.com/api/v1/declarations?market=de&cluster=true&minAmount=500000" \
-H "Authorization: Bearer sit_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
GET/api/v1/declarations/{amfId}
Detalle de una declaración (con backtest)
Objeto completo que incluye el backtest minorista T+30/90/365 si está calculado. Entrada: cierre de pubDate+1.
Descomponer un signalScore en 7 factores ponderados
Devuelve el valor, los puntos brutos asignados, el tope y una breve justificación para cada uno de los 7 factores del score compuesto v3. Sin caja negra: audita cualquier señal tú mismo. Metodología: ver /methodology.
Parámetros de ruta
Nombre
Tipo
Por defecto
Descripción
amfIdobligatorio
string
·
Identificador único (p. ej. 2026DD1108988 o SEC:0001127602-25-009876)
Señales que cumplen los 6 filtros de la cohorte de vigilancia heredada (clúster, mid-cap, cargos clave, frescura ≤ 7 d, adquisición, score v3 ≥ 40). Solo vigilancia: sin rentabilidad esperada ni asignación validada, la respuesta lo indica en su bloque proof.
Seguimiento real por grupo de puestos (Top 3, 5, 10)
Las mismas cifras que /performance: una posición por empresa desde su primer día en el top k, rentabilidad frente al índice de su región en las mismas fechas, a 30 días, 90 días y 1 año, con cobertura e intervalos al 95 %. Versión 2 desde el 13/10/2026. Público, sin clave API.
Hace de proxy de las rutas READ de /api/v1/* sin autenticación. Límite móvil de 24 h: 10 llamadas por huella (3 para user-agents de bots). IP de centros de datos rechazadas, captcha a partir de la 6.ª llamada, marca de agua en cada respuesta. Bulk export, MCP y webhooks NO pasan por el proxy.
bash
# No hace falta ninguna cabecera. Pruébalo:
curl "https://insiders-trades.com/api/v1/sandbox/declarations?limit=3"
curl "https://insiders-trades.com/api/v1/sandbox/signals?direction=BUY&limit=5"
curl "https://insiders-trades.com/api/v1/sandbox/status"
POST/api/v1/sandbox/challenge
POW para user-agents de bots
Emite un challenge HMAC (dificultad de 16 bits, TTL de 10 min). El cliente debe encontrar un nonce tal que sha256(challenge + ':' + nonce) empiece por 4 ceros hex y reenviar X-Sandbox-POW-Challenge + X-Sandbox-POW-Solution en la siguiente llamada.
bash
curl -X POST "https://insiders-trades.com/api/v1/sandbox/challenge"
Esquema
Modelo de datos
Cinco entidades principales. Estos son los campos expuestos en la API (algunos campos internos, como índices o marcas de tiempo técnicas, no se incluyen).
Beta privada: sin límite de páginas web, 20 solicitudes sandbox/día con una cuenta Free (el contador se reinicia a las 00:00 UTC). Las claves API empiezan con Pro y Quant.
10 solicitudes/segundo (ráfaga) · suficiente para la mayoría de usos. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (ISO 8601).
10 claves activas como máximo por cuenta. Por encima, revoca una desde tu página de claves.
Los contadores de uso son visibles en tiempo real para el usuario (total + hoy) y para el administrador (con los principales consumidores).
Buenas prácticas
Respeta la frescura. Los datos no cambian cada segundo. Los precios se actualizan una vez al día y las declaraciones de directivos de nuestros 46 mercados (AMF, SEC, BaFin, SIX SER, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo, Helsinki, Copenhagen, ASX, FMA, CVM, HKEX, BSE-Sofia, Tadawul, DART, EDINET, SSE, SZSE, SEBI, KNF, PSE, NZX, JSE y más) varias veces al día según la fuente. Consulta meta.dataFreshness para adaptar tu frecuencia de polling.
Cachea de forma agresiva. El detalle de una empresa cambia poco, cachéalo en el cliente hasta priceAt + 1h.
Pagina correctamente. Usa un limit razonable (20-50) y offset para grandes volúmenes de datos.
Reintenta los 5xx. Con back-off exponencial, máx. 5 intentos.
Guarda tu clave de forma segura. Nunca en texto plano en un repo Git, en el frontend ni en los logs.
Ejemplos
Ejemplos de código
Obtener las señales principales del día
const API = "https://insiders-trades.com";
const KEY = process.env.INSIDERS_API_KEY;
async function topSignals(direction = "BUY", days = 1) {
const url = new URL(API + "/api/v1/signals");
url.searchParams.set("direction", direction);
url.searchParams.set("lookbackDays", String(days));
url.searchParams.set("minScore", "50");
url.searchParams.set("limit", "10");
const res = await fetch(url, {
headers: { Authorization: "Bearer " + KEY },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { items, meta } = await res.json();
console.log(`${items.length} signals · latency ${meta.latencyMs}ms`);
for (const s of items) {
console.log(
`[${s.signal.score}] ${s.company.name.padEnd(32)} ${s.insider.name} · ${s.transaction.amount}€`
);
}
}
topSignals();
Exportar a CSV todas las declaraciones de una empresa
import csv, os, requests
API = "https://insiders-trades.com"
KEY = os.environ["INSIDERS_API_KEY"]
def fetch_all(slug):
items, offset = [], 0
while True:
r = requests.get(
f"{API}/api/v1/companies/{slug}/declarations",
params={"limit": 100, "offset": offset},
headers={"Authorization": f"Bearer {KEY}"},
)
r.raise_for_status()
page = r.json()
items.extend(page["items"])
if offset + 100 >= page["total"]:
break
offset += 100
return items
with open("bouygues_declarations.csv", "w", newline="") as f:
rows = fetch_all("bouygues-1454")
w = csv.writer(f)
w.writerow(["pubDate", "insider", "role", "nature",
"isin", "unitPrice", "volume", "amount", "score"])
for d in rows:
w.writerow([
d["pubDate"],
d["insider"]["name"],
d["insider"]["function"],
d["transaction"]["nature"],
d["transaction"]["isin"],
d["transaction"]["unitPrice"],
d["transaction"]["volume"],
d["transaction"]["totalAmount"],
d["signal"]["score"],
])
print(f"Wrote {len(rows)} rows")
Versionado
Registro de cambios
v1.0.0· 2026-04-20
Lanzamiento de la API pública.
18 endpoints, autenticación por clave API, metadatos de frescura y de límite de uso en cada respuesta.
11 oct. 2026: el campo gender se elimina de los objetos insider (REST, OpenAPI, MCP). Era inferido, no declarado, y ya no se publica.
Soporte
Ayuda, comentarios, SLA
La API está en beta privada. El acceso es por invitación. Durante la beta no se ofrece SLA contractual, pero el equipo vigila a diario la frescura de los datos (varias recogidas al día en los mercados, precios actualizados a diario).
Error / anomalía: indica la URL exacta, la hora (UTC) y el prefix de la clave utilizada.
Hoja de ruta: endpoints POST para notificaciones push, webhooks sobre nuevas señales, permisos granulares.
Uso ético. Las declaraciones de directivos (AMF, SEC, BaFin, SIX, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo, Helsinki, Stockholm, Copenhagen, ASX, FMA, Dublin y más) son públicas, pero el límite de uso también protege a los reguladores y proveedores de datos que leemos. Los patrones abusivos conllevan la revocación inmediata de la clave.
¿Listo para integrar la señal de los directivos?
Genera una clave en 10 segundos, copia el ejemplo cURL del inicio rápido y explora los endpoints en vivo con Swagger.