Metrics & Dividends: un nuevo endpoint específico para datos financieros a nivel de activo

Un nuevo endpoint, Metrics & Dividends, ya está disponible en la API de FinImpulse. El endpoint devuelve un conjunto consolidado de métricas financieras y de mercado para un único símbolo de activo. En lugar de recuperar una instantánea completa de datos y filtrar lo que no es relevante para un análisis concreto, ahora es posible consultar directamente datos de dividendos y de rendimiento histórico, rentabilidad, crecimiento, apalancamiento e indicadores de calidad del negocio mediante una única request centrada.

Cobertura del endpoint de métricas y compatibilidad con los activos

El endpoint Metrics & Dividends devuelve cinco categorías generales de datos, cada una de las cuales aborda un aspecto distinto del perfil financiero de un activo.

• Dividendos y rentabilidad: abarca la tasa de dividendo y la rentabilidad por dividendo, tanto forward como trailing, incluidas las cifras normalizadas a USD.
• Rentabilidad y rendimiento: incluye cifras de rentabilidad total a uno y tres años.
• Indicadores técnicos: abarca las variaciones de precio respecto a las medias móviles de 50 y 200 días, así como la variación de las últimas 52 semanas.
• Rentabilidad y márgenes: incluye las métricas de margen de flujo de caja libre (FCF), retorno sobre el capital invertido (ROIC), margen neto y rentabilidad financiera (ROE).
• Crecimiento y riesgo: Agrupa las métricas de beta, ratio deuda/patrimonio neto (D/E), estabilidad de los ingresos, crecimiento de los ingresos y crecimiento del EPS.

Este abanico de métricas hace que el endpoint resulte adecuado para una amplia variedad de workflows, desde dar soporte a la consulta de un solo activo hasta alimentar una función de analítica más amplia.

Consulta la documentación del endpoint para ver ejemplos completos de request y response.

Compatibilidad por tipo de activo

El endpoint Metrics & Dividends se aplica principalmente a las acciones. Sus métricas fundamentales y de rentabilidad se derivan de los datos de los estados financieros que presentan las acciones, pero que los ETF y los fondos de inversión, al tratarse de estructuras de inversión colectiva, no presentan. En el caso de los fondos, los campos vinculados a la rentabilidad, el crecimiento y la calidad del negocio se devuelven en general como null.

Casos de uso y workflows de ejemplo

En la práctica, el endpoint de métricas puede ser un complemento útil para toda una serie de workflows, tanto analíticos como creados por desarrolladores:

• En el plano del análisis, permite realizar comparaciones directas entre activos sin necesidad de un conjunto de datos más amplio.
• En el plano del desarrollo, puede servir como fuente de datos de un componente de dashboard o de un pipeline automatizado.

Veamos algunos ejemplos:

Comparación de riesgo por sector

Al comparar empresas del mismo sector, las diferencias de volatilidad y apalancamiento no siempre resultan visibles si solo se observa la evolución del precio. Al llamar al endpoint Metrics & Dividends se obtiene el conjunto completo de métricas para cada ticker. De ellas, la beta y el ratio deuda/patrimonio neto son las dos relevantes para esta comparación. Comparadas lado a lado, estas cifras pueden revelar si una empresa presenta un mayor apalancamiento o reacciona con mayor intensidad que sus pares a los movimientos del mercado.

Dashboard de gestión patrimonial

Un caso de uso más elaborado es crear y mantener un dashboard de gestión patrimonial. En lugar de abrir cada activo individualmente, se puede consultar el endpoint de métricas para cada posición de la cartera. La response devuelve la rentabilidad por dividendo, el ROE, la beta y otras cifras en conjunto, de modo que no hace falta obtener cada métrica por separado.

Informe diario de cartera

El mismo enfoque puede extenderse a un informe automatizado de cartera. Un proceso programado llama al endpoint de métricas para cada posición a intervalos regulares y recopila los cambios, como la variación del precio a 52 semanas o la tasa de dividendos más recientes. Un modelo de IA puede entonces convertir estas cifras en un informe que combine un breve resumen escrito de los cambios con los números subyacentes.

En todos estos ejemplos se mantiene el mismo principio: el endpoint Metrics & Dividends proporciona un conjunto específico de datos financieros acotado a un símbolo — desde una comparación puntual hasta un informe totalmente automatizado — a la vez que mantiene cada implementación sencilla.

Dentro de la API de FinImpulse, el endpoint de métricas puede combinarse con otros para crear workflows y herramientas más completos.