Cómo obtener fechas de resultados y detectar si una empresa superó o no las expectativas con APIs abiertas

2. AInvest: útil para detectar si el resultado superó expectativas

Si tu objetivo principal es saber si el resultado superó o no el consenso, AInvest ofrece un endpoint de calendario con campos muy útiles.

Ejemplo de respuesta del API:

• eps_actual
• eps_forecast
• eps_surprise
• revenue_actual
• revenue_forecast

Estos campos permiten determinar directamente el resultado:

• eps_actual > eps_forecast

  → Beat (superó expectativas)

• eps_actual < eps_forecast

  → Miss (por debajo de expectativas)

• eps_actual == eps_forecast

  → Inline (en línea con expectativas)

El endpoint se consulta con:

requiriendo autenticación mediante token.

3. Bigdata: datos de earnings surprise ya calculados

Otra alternativa es el endpoint de Earnings Surprises de Bigdata.

Devuelve campos como:

• eps_actual
• eps_estimated
• eps_surprise_pct
• revenue_actual
• revenue_estimated
• reporting_date

Esto permite analizar directamente si el resultado fue mejor o peor que las estimaciones sin tener que calcularlo manualmente.

Este tipo de endpoint es especialmente útil para procesos automáticos que revisan earnings ya publicados.

4. Otras APIs que también ofrecen calendarios de resultados

Además de las anteriores, existen varios servicios que proporcionan datos similares:

API Ninjas

• Endpoint de earnings calendar
• Permite consultar resultados pasados y fechas futuras
• Puede filtrarse por ticker o fecha.

StockFit Earnings API

Incluye varios endpoints especializados:

• calendario de resultados próximos
• consulta por ticker
• snapshot de resultados
• historial de EPS

Esto permite construir pipelines completos de análisis de resultados.

EarningsAPI

Algunas implementaciones agrupan los eventos por momento del anuncio:

• pre (antes de la apertura)
• after (después del cierre)

lo que facilita mostrar directamente si el resultado fue pre‑market o after‑hours.

MarketData API

También devuelve campos como reportTime con valores como "before market open".

Ejemplo de estructura de datos para tu sistema

Una forma práctica de integrar todo esto en tu lista de señales podría ser un esquema como este:

Donde:

• earnings_status

  • reported
  • upcoming

• earnings_session

  • pre-market
  • after-hours

• surprise_result

  • beat
  • miss
  • inline
  • pending

Lógica de ejemplo en Python:

Conclusión

Si necesitas integrar información de resultados corporativos en un sistema de señales o trading, una arquitectura práctica sería:

1. OpenBB para obtener el calendario de resultados futuros e históricos.
2. AInvest o Bigdata para determinar si el resultado estuvo por encima o por debajo de las expectativas.
3. APIs adicionales como API Ninjas, EarningsAPI o StockFit como fuentes alternativas o redundantes.

Con esta combinación puedes construir una columna automática en tu lista de señales que muestre algo como:

• 12‑05 pre‑market

• after‑hours
• Beat
• Miss

sin necesidad de procesar manualmente los datos cada día.