El registro de iniciados, por HTTP.

Una API JSON de solo lectura sobre los mismos datos que el sitio y el servidor MCP: operaciones con sus señales, iniciados con sus historiales, empresas con sus fundamentales. Incluida en el plan Desk.

Crear una clave Ver planes

Autenticación

Crea una clave en tu cuenta y envíala como token bearer. Una clave se muestra una sola vez y solo se guarda su hash; revócala en cuanto se filtre.

Petición

curl -H "Authorization: Bearer il_…" \
  "https://insiderlens.com/api/v1/transactions?signal=cluster_buy&limit=5"

Límites

10.000 peticiones al mes por plaza con Desk (3 plazas), 600 por hora y clave. Cada respuesta lleva X-Quota-Limit y X-Quota-Remaining. Una petición rechazada por parámetros no válidos no cuenta.

Uso de los datos

Para tus propios análisis y los de tu empresa. Republicar o revender los datos, o alimentar con ellos un producto competidor, requiere una licencia Institutional: hablemos.

Endpoints

GET/api/v1/transactions

Las operaciones de iniciados vigentes, la notificación más reciente primero. Los filtros se combinan; las listas separadas por comas aceptan cualquiera de sus valores. Pagina con next_cursor.

issuer: Id de la empresa
insider: Id del iniciado
ticker: Ticker de la empresa, p. ej. AAPL
code: P, S, A, M, G, O (lista)
signal: cluster_buy, size_anomaly, first_buy_12mo (lista)
source: sec_edgar, amf, bafin
min_value_usd: Valor mínimo en USD
filed_from: Notificada a partir del, AAAA-MM-DD
filed_to: Notificada hasta el, AAAA-MM-DD
limit: 1 a 100, 50 por defecto
cursor: next_cursor de la página anterior

GET/api/v1/insiders/{id}

Un iniciado por id o slug de página: cargos, actividad e historial (tasas de acierto, rentabilidades medianas, marca de iniciado probado).

GET/api/v1/issuers/{id}

Una empresa por id, slug de página o ticker: identificadores, actividad de iniciados y los últimos fundamentales.

GET/api/v1/clusters

Clústeres de varios iniciados: 3 o más iniciados operando en la misma empresa y en el mismo sentido en 90 días, los más recientes primero.

direction: buy (por defecto) o sell
since: Ventana terminada a partir del, AAAA-MM-DD (por defecto: hace 30 días)
limit: 1 a 100, 50 por defecto

GET/api/v1/backtests

El último registro de backtests de señales: cada celda probada, incluidas las señales que fallan.

signal: Clave de la señal, p. ej. cluster_buy, first_buy_12mo
horizon: Horizonte en días: 21, 63, 126 o 252

Respuesta

Forma de una página de operaciones

{
  "data": [
    {
      "id": "…",
      "filed_at": "2026-09-24T00:00:00.000Z",
      "transaction_date": "2026-09-22",
      "code": "P",
      "shares": 25000,
      "price": 41.2,
      "currency": "USD",
      "value_usd": 1030000,
      "insider": { "id": "…", "name": "…", "slug": "…" },
      "issuer": { "id": "…", "name": "…", "slug": "…" },
      "signals": { "cluster_buy": true, "size_anomaly": false, "first_buy_12mo": true, … },
      "conviction_score": 81,
      "returns": { "d21": 0.064, … },
      …
    }
  ],
  "next_cursor": "eyJ…"
}

Errores

Los errores vuelven en JSON, con el estado HTTP y el código de abajo y un mensaje legible:

{ "error": { "code": "…", "message": "…" } }

400: invalid_parameters; Un parámetro es desconocido o está mal formado. No se ha contado nada.
401: unauthorized; Clave ausente, desconocida o revocada.
403: plan_required; La cuenta de la clave no está en Desk.
404: not_found; No existe ese iniciado o esa empresa.
429: rate_limited; Más de 600 peticiones en la hora para esta clave.
429: quota_exceeded; La cuota del mes está agotada. Se renueva el día 1.
503: unavailable; La consulta no pudo completarse. Vuelve a intentarlo en breve.