Auf USD normalisierte Dividendenfelder im FinImpulse-Such-Endpoint
Zwei neue, auf USD normalisierte Felder für die Dividendenrate im FinImpulse-Such-Endpoint: Feldreferenz, Response-Struktur und Integrationsmuster.
Dividendenraten aus globalen Märkten werden in lokalen Währungen ausgewiesen. Für Pipelines und Screener, die Assets aus mehreren Märkten abfragen, sind Dividendenbeträge je Aktie ohne Normalisierung auf eine einheitliche Währungseinheit nicht direkt vergleichbar.
Die FinImpulse API wendet die Normalisierung auf der Datenschicht an und deckt damit nun auch Dividendenraten ab.
Übersicht: Dividendenraten-Felder in USD
Der Such-Endpoint enthält jetzt zwei auf USD normalisierte Felder für die Dividendenrate: „dividend_rate_usd“ und „trailing_annual_dividend_rate_usd“. Beide sind vom Typ number und geben null zurück, wenn für ein Asset keine Dividendendaten verfügbar sind.
Es handelt sich um die auf USD normalisierten Gegenstücke der bestehenden Felder „dividend_rate“ und „trailing_annual_dividend_rate“. Die Umrechnung erfolgt serverseitig mit dem aktuellen Wechselkurs der Originalwährung des Assets.
Response-Beispiel
Das folgende Beispiel zeigt eine Response für AAPLCO.CL (Apple Inc., gelistet an der Bolsa de Valores de Colombia in kolumbianischen Pesos).
{...
"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“ und „trailing_annual_dividend_rate“ geben den lokalen COP-Betrag wieder; die „_usd“-Gegenstücke geben den zum aktuellen Wechselkurs umgerechneten Wert wieder.
Forward und Trailing: der entscheidende Unterschied
Die Forward- und Trailing-Werte erfüllen in einer Daten-Pipeline unterschiedliche Funktionen.
- „dividend_rate_usd“ ist der passende Wert, wenn die Abfrage die aktuelle Dividendenerwartung betrifft.
- „trailing_annual_dividend_rate_usd“ — wenn die Abfrage verifizierte historische Dividendendaten betrifft.
Auch die Differenz zwischen den beiden Werten für dasselbe Asset ist aussagekräftig. Eine deutliche Abweichung kann auf eine kürzliche Änderung der Dividendenpolitik hindeuten, etwa auf eine Dividendenerhöhung, eine Kürzung oder eine Aussetzung mit anschließender Wiedereinführung. Wer Assets abfragt, bei denen die beiden Werte über eine definierte Schwelle hinaus auseinanderliegen, kann Änderungen der Dividendenpolitik aufdecken, die aus Renditedaten allein nicht ersichtlich wären.
Arbeiten mit auf USD normalisierten Dividendendaten
Die USD-Normalisierung auf der Datenschicht bedeutet, dass beide Felder Werte zurückgeben, die direkt in Abfragen, Aggregationen und Exporten verwendet werden können. Da das Schema für Aktien, ETFs und Fonds einheitlich ist, gilt dieselbe Logik unabhängig vom Asset-Typ oder Börsenplatz.
„dividend_rate_usd“ kann als Eingabewert für Screener- und Ranking-Implementierungen dienen — etwa zum Filtern von Assets nach einem Mindestwert für die Forward-Dividende oder zum Sortieren nach dem absoluten Wert über alle Märkte hinweg. „trailing_annual_dividend_rate_usd“ ist der passende Eingabewert, wo verifizierte historische Werte erforderlich sind: Reporting-Workflows, Datenexporte und nachgelagerte Pipelines, die auf tatsächlichen statt auf prognostizierten Daten basieren.
Da beide Felder numerisch sind und asset-übergreifend einem einheitlichen Schema entsprechen, können sie auch als direkte Eingaben für ML- und KI-Modelle dienen — entweder als eigenständige Features oder kombiniert als Delta-Feature, das das Ausmaß einer kürzlichen Änderung der Dividendenpolitik abbildet.
Neue Konten erhalten bei der Registrierung API-Guthaben in Höhe von 1 $.
