Desarrolladores

La API de Datos Financieros

Datos reales de acciones de EE. UU. — presentaciones del SEC, transacciones de inversores internos, tenencias institucionales de 13F y resúmenes de ganancias — en formato JSON limpio. Seguro para licencias, gestionado en privado, limitado por velocidad según el plan. Información general únicamente, nunca asesoramiento.

Crear una cuenta →Iniciar sesión con una clave

Límites de velocidad por plan

Plan	Req/min	Req/día	Máx. páginas	narrativa de IA
Pulse	10	200	10	solo hechos
Signal	60	5000	50	✓
Insider	180	50000	100	✓
Founders	300	200000	200	✓

Todos los planes incluyen datos de la SEC de dominio público (cifras, fechas, presentaciones). Los planes de pago reciben adicionalmente resúmenes factuales redactados por IA. Las respuestas incluyen encabezados X-RateLimit, y las llamadas que excedan el límite devuelven HTTP 429 con Retry-After.

Puntos finales

URL base: https://investwhen.com/api/v1 · Autenticar con un encabezado: Authorization: Bearer <key>

GET /api/v1/metaTu plan, límites y uso actual.

GET /api/v1/finance/reports?ticker=AAPLPerfiles de empresas factuales (lista, o un ticker).

GET /api/v1/finance/insiders?ticker=TSLASeñales de compra/venta de insider en el mercado abierto (Form 4) + operaciones notables.

GET /api/v1/finance/whales?cik=1067983Posiciones institucionales de 13F y movimientos de trimestre a trimestre.

GET /api/v1/finance/earnings?ticker=NVDAResúmenes de ganancias reales de los informes 8-K de las propias empresas.

GET /api/v1/finance/filings?ticker=MSFTPresentaciones recientes de la SEC con resúmenes factuales.

Parámetros de consulta comunes: limit (limitado a la página máxima de su plan), ticker / cik.

Ejemplo

curl -s https://investwhen.com/api/v1/finance/insiders?ticker=TSLA \
  -H "Authorization: Bearer iw_live_your_key_here"

OpenAPI especificación

La superficie completa como un documento OpenAPI 3.1 legible por máquina — importe esto a Postman, Insomnia o un generador de SDK en lugar de escribirlo a mano. No necesita clave para leerlo, y los límites de velocidad en él se generan a partir de los que realmente hace cumplir la API, por lo que no pueden desviarse.

/api/v1/openapi.json

# import into any OpenAPI tool
curl -s https://investwhen.com/api/v1/openapi.json -o investwhen.json

# or generate a typed client (example: Python)
openapi-python-client generate --url https://investwhen.com/api/v1/openapi.json

{
  "ok": true,
  "api_version": "v1",
  "license": "SEC EDGAR (U.S. government, public domain) + InvestWhen factual summaries…",
  "count": 1,
  "data": [{
    "type": "insider", "ticker": "TSLA", "window_days": 90,
    "net_usd": -4200000, "n_buys": 0, "n_sells": 3, "cluster_buying": false,
    "notable": [{"insider": "…", "role": "Director", "code": "S", "value_usd": 1800000, "date": "2026-06-14"}]
  }]
}

Los datos se obtienen del SEC EDGAR (dominio público de EE. UU.) y de los resúmenes factuales propios de InvestWhen. Es información general y de mercado para el público en general — no es asesoramiento de inversión, no es una recomendación personal ni una solicitud para comprar o vender ningún valor. Consulte la Términos y DPA.