Fundamental Daten API

fundamental daten api

Fundamentale Finanzdaten von Aktien weltweit

Wir bieten unseren Premiumkunden Zugriff auf folgende Fundamental Daten API's an:

  1. API_Fundamentals enthält fundamentale Daten aus den Geschäftsberichten: Ergebnis je Aktie (verwässert), Gesamtkapital, Eigenkapital, operativer Netto Cashflow, Investitionsausgaben, freier Cashflow, Gewinn/Verlust, Aktien im Umlauf, Umsatz netto.
  2. API_Dividend enthält die jährlichen Dividenden (splitbereinigt ohne Sonderdividende).
  3. API_Fscore enthält unseren F-Score für jeden vergangenen Börsentag.
  4. API_Pricetobook enthält das Kurs-Buch-Verhältnis (KBV) für jeden vergangenen Börsentag.
  5. API_Pricetocashflow enthält das Kurs-Cash-Flow-Verhältnis (KCV) für jeden vergangenen Börsentag.
  6. API_Pricetoearning enthält das Kurs-Gewinn-Verhältnis (KGV) für jeden vergangenen Börsentag.
  7. API_Pricetofreecashflow enthält das Kurs-Free-Cash-Flow-Verhältnis (KFCV) für jeden vergangenen Börsentag.
  8. API_Pricetosales enthält das Kurs-Umsatz-Verhältnis (KUV) für jeden vergangenen Börsentag.
  9. API_Roa enthält die Profitabilität (GKR) für das Geschäftsjahr.
  10. API_Roe enthält die Eigenkapitalquote (EKQ) für das Geschäftsjahr.

Shareuid ermitteln

Für die Abfrage der Fundamentaldaten über unsere API benötigen Sie die Shareuid für die gesuchte Aktie. Diese können Sie entweder über die API selbst ermitteln oder aus der Excel-Tabelle entnehmen. WICHTIG: Hier ist auch die Währung bindend enthalten, die bei den API_Fundamentals Ergebnissen ausgegeben wird.

Syntax: name = Suche mit Firmenname, wkn = Suche mit WKN, isin = Suche mit ISIN, token = Ihr Finanzoo Token (https://www.finanzoo.de/account/api.html) – Sie benötigen einen Premium Account für die Nutzung.

Beispiel Aufrufe:

https://api.finanzoo.de/v2/public/?API_Index&name=ibm&token=YOURTOKEN
https://api.finanzoo.de/v2/public/?API_Index&wkn=851399&token=YOURTOKEN
https://api.finanzoo.de/v2/public/?API_Index&isin=US4592001014&token=YOURTOKEN

Beispiel Antwort:

{"shareuid":"2","isin":"US4592001014","wkn":"851399","currency":"USD","shortname":"IBM","name":"International Business Machines Corp.","country":"Vereinigte Staaten von Amerika","indizes":"Dow Jones Industrial Average,S&P 500","sector":"Technology","lastbalanceupdate":"2020-01-26"}

Hinweis: Eine statische Shareuid-Tabelle pflegen wir nicht mehr, da sich die IDs durch neu aufgenommene Aktien laufend ändern. Ermitteln Sie die Shareuid stattdessen immer aktuell über API_Index (siehe oben).

API_Fundamentals

Syntax: shareuid, from, to, token – Sie benötigen einen Premium Account für die Nutzung.

https://api.finanzoo.de/v2/public/?API_Fundamentals&shareuid=2&from=2019-01-01&to=2020-03-31&token=YOURTOKEN

Beispiel Antwort:

[{"year":"2019","eps":"10.566","total_liabilities":"152186000000","operating_cashflow":"14770000000","capex":"-2370000000","free_cashflow":"12400000000.00","total_equity":"20841000000","net_income":"9431000000","net_revenue":"77147000000","outstandingshares":"892580000"}]

API_Dividend

Syntax: shareuid, from, to, token – Sie benötigen einen Premium Account für die Nutzung.

https://api.finanzoo.de/v2/public/?API_Dividend&shareuid=2&from=1919-01-01&to=2020-03-31&token=YOURTOKEN

API_Fscore

https://api.finanzoo.de/v2/public/?API_Fscore&shareuid=2&from=2020-02-15&to=2020-03-15&token=YOURTOKEN

API_Pricetobook

https://api.finanzoo.de/v2/public/?API_Pricetobook&shareuid=2&from=2019-12-15&to=2020-03-15&token=YOURTOKEN

API_Pricetocashflow

https://api.finanzoo.de/v2/public/?API_Pricetocashflow&shareuid=2&from=2020-02-15&to=2020-03-15&token=YOURTOKEN

API_Pricetoearning

https://api.finanzoo.de/v2/public/?API_Pricetoearning&shareuid=2&from=2019-12-15&to=2020-03-15&token=YOURTOKEN

API_Pricetofreecashflow

https://api.finanzoo.de/v2/public/?API_Pricetofreecashflow&shareuid=2&from=2020-01-02&to=2020-03-15&token=YOURTOKEN

API_Pricetosales

https://api.finanzoo.de/v2/public/?API_Pricetosales&shareuid=2&from=2020-01-01&to=2020-03-15&token=YOURTOKEN

API_Roa

https://api.finanzoo.de/v2/public/?API_Roa&shareuid=2&from=2019-01-01&to=2020-03-15&token=YOURTOKEN

API_Roe

https://api.finanzoo.de/v2/public/?API_Roe&shareuid=2&from=2019-01-01&to=2020-03-31&token=YOURTOKEN

Finanzoo V2 API

Unsere aktuelle API-Version ist V2, verfügbar unter der Basis-URL https://api.finanzoo.de/v2/public/ (siehe Beispielaufrufe oben). Sie verwendet dieselbe Aufruf-Syntax wie die frühere V1-API (Endpunktname als Query-Flag, gefolgt von den jeweiligen Parametern und Ihrem Token).

Eine vollständige, interaktive Swagger-Dokumentation aller V2-Endpunkte (inkl. Beispielaufrufe und Antwortschemata) finden Sie unter /swagger unter dem Tag PublicApi.

Hinweis zu API_Fundamentals (V2): Zusätzlich zu den oben gezeigten Legacy-Feldern liefert API_Fundamentals in V2 je Geschäftsjahr weitere Kennzahlen, sofern verfügbar: gross_profit, operating_income, investing_cashflow, financing_cashflow, total_assets, current_assets, current_liabilities, long_term_debt und dividends_paid. Die bisherigen Felder bleiben unverändert erhalten.

Zugriffsrechte je Kontotyp (V2):

  • Business-Accounts erhalten wie in V1 uneingeschränkten Zugriff auf alle Aktien.
  • Zahlende Premium-Accounts (nicht Business) erhalten Zugriff auf Apple, Siemens und Makita.
  • Kostenlose Accounts erhalten ausschließlich Zugriff auf Apple.

Fragen Sie eine Aktie ab, auf die Ihr Kontotyp keinen Zugriff hat, antwortet die API mit HTTP-Status 403 Forbidden. Ein ungültiges oder abgelaufenes Token führt zu 401 Unauthorized. Die Aktienfilter-Endpunkte API_Getfilteredshares, API_Getindices, API_Getcountries und API_Gics stehen aktuell ausschließlich in der V1-API zur Verfügung und haben in V2 noch keine Entsprechung.

Fundamental Data API Zugriff mit PHP

$requesturl = "https://api.finanzoo.de/v2/public/?API_Fundamentals&shareuid=2&from=2019-01-01&to=2020-03-31&token=YOURTOKEN";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $requesturl);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true );

$response = curl_exec($ch);

curl_close($ch);

var_dump(json_decode($response,true));

Fundamental Data RESTful API C#

using System;
using System.Net;

namespace FundamentalData
{
    class Program
    {
        static void Main(string[] args)
        {
            string url = "https://api.finanzoo.de/v2/public/?API_Fundamentals&shareuid=2&from=2019-01-01&to=2020-03-31&token=YOURTOKEN";
            string response = GetFundamentalData(url);
            Console.WriteLine(response);
            Console.ReadLine();
        }

        public static string GetFundamentalData(string url)
        {
            string response = string.Empty;
            using (WebClient client = new WebClient())
            {
                client.Headers["User-Agent"] = "Mozilla/4.0 (Compatible; Windows NT 5.1; MSIE 6.0)";
                response = client.DownloadString(url);
            }
            return response;
        }
    }
}

Fragen und Anregungen

Sie haben Fragen oder Anregungen zu unserer API? Verwenden Sie bitte unser Kontaktformular mit dem Betreff "API Frage".