Campos de dividendos normalizados en USD en el endpoint de búsqueda de FinImpulse
Dos nuevos campos de tasa de dividendos normalizados en USD en el endpoint de búsqueda de FinImpulse: referencia de campos, estructura de la respuesta y patrones de integración.
Los datos de tasa de dividendos de los mercados globales están denominados en divisas locales. Para pipelines y screeners que consultan activos de varios mercados, los importes de dividendo por acción no son directamente comparables sin una normalización a una unidad monetaria común.
La API de FinImpulse aplica la normalización en la capa de datos, y esta ahora se extiende a las tasas de dividendos.
Resumen de los campos de tasa de dividendos en USD
El endpoint de búsqueda incluye ahora dos campos de tasa de dividendos normalizados en USD: «dividend_rate_usd» y «trailing_annual_dividend_rate_usd». Ambos son de tipo number y devuelven null cuando no se dispone de datos de dividendos para un activo determinado.
Son las contrapartidas normalizadas en USD de los campos existentes «dividend_rate» y «trailing_annual_dividend_rate». La conversión se aplica en el servidor con el tipo de cambio actual de la divisa nativa del activo.
Ejemplo de respuesta
El siguiente ejemplo muestra una respuesta para AAPLCO.CL (Apple Inc., cotizada en la Bolsa de Valores de Colombia en pesos colombianos).
{...
"trailing_annual_dividend_rate": 0.52,
"trailing_annual_dividend_rate_usd": 0.000140478,
"trailing_annual_dividend_yield": 5.561e-5,
"dividend_rate": 3970.26,
"dividend_rate_usd": 1.072565739,
"dividend_yield": 0.41,
...}
«dividend_rate» y «trailing_annual_dividend_rate» reflejan el importe local en COP; las contrapartidas «_usd» reflejan el valor convertido según el tipo de cambio vigente.
Forward y trailing: la diferencia clave
Las cifras forward y trailing cumplen funciones distintas en un pipeline de datos.
- «dividend_rate_usd» es el valor adecuado cuando la consulta se refiere a la expectativa actual de dividendos.
- «trailing_annual_dividend_rate_usd» — cuando la consulta se refiere a datos históricos verificados de dividendos.
El delta entre los dos valores de un mismo activo también es significativo. Una divergencia considerable puede indicar un cambio reciente de política, como un aumento del dividendo, un recorte o una suspensión seguida de su restablecimiento. Consultar los activos en los que ambos valores divergen más allá de un umbral definido permite detectar cambios en la política de dividendos que no serían visibles solo con los datos de rentabilidad por dividendo.
Trabajo con datos de dividendos normalizados en USD
La normalización en USD en la capa de datos implica que ambos campos devuelven valores listos para su uso directo en consultas, agregaciones y exportaciones. Como el esquema es coherente entre acciones, ETF y fondos, la misma lógica se aplica con independencia del tipo de activo o del mercado de cotización.
«dividend_rate_usd» puede servir de entrada para implementaciones de screeners y rankings: filtrar activos por un umbral mínimo de dividendo forward u ordenarlos por importe absoluto en los distintos mercados. «trailing_annual_dividend_rate_usd» es la entrada adecuada cuando se requieren valores históricos verificados: workflows de reporting, exportaciones de datos y pipelines posteriores que dependen de datos reales y no proyectados.
Dado que ambos campos son numéricos y comparten un esquema coherente entre tipos de activo, también pueden servir como entradas directas para modelos de ML e IA, ya sea como características independientes o combinadas en una característica delta que represente la magnitud de un cambio reciente en la política de dividendos.
Las cuentas nuevas reciben 1 USD en créditos de API al registrarse.
