Chart API

… for sharing ideas

SmartDeer verfügt über eine leistungsfähige Schnittstelle, die Aktiencharts als JPG-Bild über eine API (Application Programming Interface) generiert. Diese kann über HTTP-Links aufgerufen werden und auch in Blogbeiträge eingebettet werden. Es ist ausdrücklich erlaubt, diese auch in externen Blogs / Websites einzubetten und zu verwenden. Die Idee hinter der „Chart API“ ist, dass man in der Community Analysen und Gedanken austauscht. Die Einbettung z.B. in ein Blog kann über folgenden HTML Code erfolgen:

<img src="https://api.smartdeer.org/image/chart/AAPL" />

Dabei kann als Basisadressen können folgende Domains verwendet werden:

  • api.smartdeer.org
  • api.smartdeer.de

Der Vorteil, den Link anstatt eines statisches Bildes einzubetten ist, dass sich das Bild der Chart API täglich aktualisiert. Ihr Blogbeitrag bleibt daher immer aktuell mit den neusten Aktienkennzahlen.


1. API – Dokumentation

1.1. Chart

Über die Chart-API kann der Chart einer Aktie in einem bestimmen Zeitbereich dargestellt werden. Im folgenden Beispiel wird der Schlusskurs der Apple-Aktie dargestellt (Symbol: AAPL):

https://api.smartdeer.org/image/chart/AAPL?lang=de

Das Symbol „AAPL“ kann gegen jedes beliebige andere Aktiensymbol ausgetauscht werden. Außerdem gibt es weitere optionale Parameter:

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem der Chart beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
to_dateLegt das Enddatum fest, wann der Chart enden soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt. Fehlt dieser Parameter, so wird der heutige Tag als Standard genommen.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
featureBestimmt welche Eigenschaft der Aktie angezeigt werden soll. Es können auch mehrerer Eigenschaften parallel angezeigt werden durch einen Komma separierte Liste von Eigenschaften ohne Leerzeichen: z.B: mcap,enterprise_value.
Die definierbaren Eigenschaften werden in der Tabelle 2 dargestellt:
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 1: Optionale Parameter der Chart Funktion

Die entsprechenden Optionen für das Feld „feature“ sind in der folgenden Tabelle dargestellt:

EigenschaftBeschreibung
closeSchlusskurs der Aktie (Standarteinstellung)
openEröffnungskurs der Aktie
highTageshöchstkurs der Aktie
lowTagestiefstkurs der Aktie
volumegehandeltes Tagesvolumen der Aktie
dividendsausgezahlte Dividenden
stock_splitsFaktor eines Aktiensplits am Handelstag
rolling_mean20 Tage Mittelwert der Aktie
mcapMarktkapitalisierung der Aktie
enterprise_valueUnternehmenswert = Markkapitalisierung + Nettoschulden
fcf_yieldFree Cash Flow Rendite
dividend_yieldDividendenrendite
totalrevenue_ttmGesamtumsatz des Unternehmens des letzten 12 Monate (Trailing Twelve Months)
ebit_ttmOperatives Einkommen des Unternehmens der letzten 12 Monate
freecashflow_ttmFree Cash Flow des Unternehmens der letzten 12 Monate
earnings_ttmNettoeinkommen des Unternehmens der letzten 12 Monate
debt_ratioVerschuldungsquote des Unternehmens
net_debt_ratioNettoverschuldungsquote des Unternehmens
leveragedas Schulden zu EBITDA Verhältnis entspricht der Anzahl der Jahre, die das Unternehmen ihr gesamtes EBITDA aufbringen muss, um diese Schulden zurück zuzahlen
net_leveragedas Netto-Schulden zu EBITDA Verhältnis entspricht der Anzahl der Jahre, die das Unternehmen ihr gesamtes EBITDA aufbringen muss, um ihre Netto-Schulden zurück zuzahlen
grossprofitratioBruttomarge
ebit_profit_marginOperative Marge
netincomeratioNettomarge
interest_coverageZinsdeckungsgrad
effective_tax_rateSteuerrate des Unternehmens
cash_ratioLiquidität 1. Grades: Verhältnis der Barmittel zu den kurzfristigen Verbindlichkeiten des Unternehmens
quick_ratioLiquidität 2. Grades: Verhältnis der kurzfristigen liquiden Mittel zu den kurzfristigen Verbindlichkeiten des Unternehmens
current_ratioLiquidität 3. Grades: Verhältnis des Umlaufvermögens zu den kurzfristigen Verbindlichkeiten des Unternehmens
capital_turnoverKapitalumschlag
pe_ratio_ttmKurs-Gewinn-Verhältnis mit dem Gewinnen der letzten 12 Monate
pcf_ratioKurs-Cashflow-Verhältnis mit dem Free Cash Flow der letzten 12 Monate
ev_ebitUnternehmenswert zu EBIT-Verhältnis
pb_ratioKurs-Buchwert-Verhältnis
ps_ratio_ttmKurs-Umsatz-Verhältnis mit den Umsätzen der letzten 12 Monate
peg_ratio_ttmKurs-Gewinn-Wachstums-Verhältnis mit dem Gewinnen und des Gewinnwachstums der letzten 12 Monate
pe_ratio_forwardKurs-Gewinn-Verhältnis für das nächste Jahr, wenn das momentane Gewinnwachstum gleich bleibt
ps_ratio_forwardKurs-Umsatz-Verhältnis für das nächste Jahr, wenn das momentane Umsatzwachstum gleich bleibt
earnings_growth_ttmGewinnwachstum der letzten 12 Monate
earnings_growth_yoyGewinnwachstum verglichen mit dem Quartal vor einem Jahr
revenue_growth_ttmUmsatzwachstum der letzten 12 Monate
revenue_growth_yoyUmsatzwachstum verglichen mit dem Quartal vor einem Jahr
roeEigenkapitalrentabilität
roceReturn on Capital Employed
piotroski_scorePiotrowski F-Score
Tabelle 2: Definierbare Eigenschaften der Chart Funktion

In den folgenden Beispiel wird gezeigt, wie der optionalen Parameter genutzt werden können, das Chart in einen bestimmten Zeitbereich mit mehreren Eigenschaften anzuzeigen.

https://api.smartdeer.org/image/chart/AAPL?feature=grossprofitratio,roce,netincomeratio&from_date=2015-01-01&figsize=10x6&to_date=2020-12-31&lang=de

Die Abbildung stellt verschiedene Profitabilitätskennzahlen der Apple Inc. im Zeitraum 2015-2020 dar.


1.2. Kerzendiagram

Die Candlestick-Funktion zeigt ein Kerzendiagram an. Auch hier gibt es wieder optionale Parameter zur Begrenzung des Zeitbereichs und der Größe der erstellten Grafik.

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem der Kerzenchart beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
to_dateLegt das Enddatum fest, wann der Kerzenchart enden soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt. Fehlt dieser Parameter, so wird der heutige Tag als Standard genommen.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 3: Optionale Parameter der Candlestick Funktion

Der folgende Link erstellt ein Kerzenchart der Apple Inc. im Sommer 2020:

https://api.smartdeer.org/image/candlestick/AAPL?to_date=2020-10-30&from_date=2020-06-01&lang=de

1.3. Bollinger Band®

Das Bollinger Band® ist ein Band mit der 2-fachen Standartabweichung um den 20-Tagesmittelwert des Aktienkurses. Es wurde in den 1980er Jahren von John Bollinger entwickelt und eignet sich um kurzfristig günstige Einstiegs- und Ausstiegspunkte in ein Investment zu finden. Auch hier gibt es wieder optionale Parameter zur Begrenzung des Zeitbereichs und der Größe der erstellten Grafik.

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem das Bollinger Band® beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
to_dateLegt das Enddatum fest, wann das Bollinger Band® enden soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt. Fehlt dieser Parameter, so wird der heutige Tag als Standard genommen.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 4: Optionale Parameter der Bollinger Band® Funktion

Die folgende URL erstellt ein Bollinger Band® der Apple Inc. im Sommer 2020:

https://api.smartdeer.org/image/bollingerband/AAPL?to_date=2020-10-30&from_date=2020-06-01&lang=de

1.4. Umsatz und Gewinn

Mit Hilfe dieser API kann man Umsatz und Gewinn Jahres- oder Quartalsweise darstellen. Auch hier gibt es wieder optionale Parameter zur Begrenzung des Zeitbereichs und der Größe der erstellten Grafik.

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem das Bollinger Band® beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
to_dateLegt das Enddatum fest, wann das Bollinger Band® enden soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt. Fehlt dieser Parameter, so wird der heutige Tag als Standard genommen.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 5: Optionale Parameter der Income Funktion

Umsatz und Gewinne in Jahren:

https://api.smartdeer.org/image/incomeyearly/AAPL?figsize=10x9&from_date=2015-01-01&lang=de

Umsatz und Gewinne in Quartalen:

https://api.smartdeer.org/image/incomequarterly/AAPL?figsize=10x9&from_date=2015-01-01&lang=de

In der quartalsweisen Darstellung sieht man deutlich, dass Apple im 4. Quartal dank des Weihnachtsgeschäfts immer mit Abstand den Größen Umsatz macht.


1.5. Umsatz nach Segmenten und Regionen

Es ist oft hilfreich zu sehen in welchen Segmenten und Regionen das Unternehmen die Umsätze erwirtschaftet, um Rückschlüsse zu ziehen, wie gut das Unternehmen diversifiziert ist.

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem das Bollinger Band® beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
byAufsplittung des Umsatzes nach „segment“ oder „region“. Der Standardwert ist „segment“ falls, dieser Parameter nicht angegeben wird.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
over_timeEs gibt 2 mögliche Anzeigemodi:
– over_time=false: Darstellung als Tortendiagramm mit den aktuellen Daten
– over_time=true: Darstellung als Balkendiagramm mit allem Daten über Zeit
Der Standardwert ist „false“.
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 6: Optionale Parameter

Die folgende Grafik zeigt die Umsatzverteilung von Apple nach Segmenten:

https://api.smartdeer.org/image/revenue_ratio/AAPL?by=segment&over_time=false&lang=de&from=now-5y
Umsatzverteilung von Apple nach Segmenten

1.6. Analystenschätzungen

Analysten geben Prognosen ab über den Ausblick des Unternehmen in den nächsten 2-3 Jahren. Das diese Prognosen nie gleich sind, bewegen sich diese in einen Bereich. Mit Hilfe des Charts „Analystenschätzungen“ können sie eine Abschätzung für die zu erwartenden Umsätze und Gewinne des Unternehmens machen und auch wie gut diese Schätzungen in der Vergangenheit waren. Auch hier gibt es wieder optionale Parameter zur Begrenzung des Zeitbereichs und der Größe der erstellten Grafik.

ParameterErklärung
from_dateLegt das Startdatum fest, ab dem das Bollinger Band® beginnen soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt.
to_dateLegt das Enddatum fest, wann das Bollinger Band® enden soll. Als Datumsformat ist das Iso-Datumsformat (z.B. 2015-01-01) oder der Unix Timestamp (z.B. 1440262758) erlaubt. Es ist auch ein relativer Zeitraum wie z.B. now, now-6M oder now-5Y erlaubt. Fehlt dieser Parameter, so wird der heutige Tag als Standard genommen.
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
estimation_onGibt den Unternehmensindikator an, der von den Analysten geschätzt wurde. Möglich sind: revenue (Umsatz), eps (Gewinn je Aktie), ebit (Operatives Einkommen), ebitda (Operatives Einkommen ohne Abschreibungen), netincome (Nettoeinkommen), sgaexpense (Vertriebsgemeinkosten)
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 7: Optionale Parameter der Analystenschätzungsfunktion

Die folgende Grafik zeigt den zu erwartenden Umsatz von Apple in den nächsten 2 Jahren:

https://api.smartdeer.org/image/analyst_estimations/AAPL?estimation_on=revenue&from_date=2010-01-01&lang=de

1.7. Discounted Cashflow Analysis

Bei der Discounted Cash-Flow-Analyse werden die zu erwartenden Gewinne bzw. Cash-Flows des Unternehmens der nächsten 5-10 Jahre auf den heuten Tag mit einer zu erwartenden Rendite abgezinst. Auf diese Weise kann unter Berücksichtigung der zukünftiger Cashflows und der aktuellen Verschuldungssituation der Faire Wert der Aktie ermittelt werden. Die genaue Methodik wird auf erklärt auf der Seite Discounted Cash-Flow Analyse.

Auch hier gibt es wieder optionale Parameter zur Begrenzung des Zeitbereichs und der Größe der erstellten Grafik.

ParameterErklärung
figsizeVerändert die Größe der generierten Grafik: z.B. 10×5 . Die Größe ist in Zoll mit jeweils 100 Bildpunkten je Zoll definiert. Ein Bild mit der figsize=10×7 hat daher eine Größe von 1000×700 Pixel.
discounted_yearsDie Anzahl der Jahre, deren Cashflows in die Zukunft in die Zukunft prognostiziert werden. Standardmäßig werden 5 Jahre angenommen.
discount_rateDer Zins mit dem die zukünftigen Cashflows abgezinst werden. Standardmäßig werden 8% angenommen.
langDefiniert die Sprache, in der die Grafik dargestellt werden soll. Erlaubt ist: de, en oder cn (deutsch, englisch bzw. chinesisch). Fehlt dieser Parameter, so ist die Sprache englisch.
Tabelle 8: Optionale Parameter der Discounted Cashflow-Analyse

Die folgende Grafik zeigt die prognostizierten Cashflows der nächsten 10 Jahre:

https://api.smartdeer.org/image/cashflow_estimations/AAPL?discounted_years=10&figsize=10x6&lang=de

Die darauf folgende Discounted Cash-Flow Analyse berechnet den fairen Wert der Apple Aktie mit einer Discount Rate von 8%.

https://api.smartdeer.org/image/dcf/AAPL?discount_rate=8&discounted_years=10&lang=de

Auf diese Weise kann man für sich selbst entscheiden, wie viel Rendite man von einem Investment erwartet und wie groß der Sicherheitsabstand zum aktuellen Kurs sein soll.


2. Aktienanalysen schreiben

Jeder ist willkommen Aktienanalysen auf SmartDeer zu schreiben und zu veröffentlichen. Es gibt dazu mehrere Wege Grafiken einzubinden:

  • Hochladen der Grafik im Forum und einbinden der entsprechenden Grafik
  • Nutzung der „Chart API“ von SmartDeer – diese hat den Vorteil, dass die Grafiken immer aktuell bleiben, da sie online aus den Aktiendaten generiert werden.

Wir empfehlen die Chart API für die Erstellung von Aktienanalysen zu verwenden. Wenn gewünscht kann auch der Zeitbereich eingeschränkt werden. Folgende Dashboards helfen bei der Erstellung der Chart Links:

  • Chart Visualization: erstellt beliebige Charts, Bollinger Band® Charts oder Kerzendiagramme
  • Fundamentals: erstellt Diagramme mit Fundamentaldaten und Analystenschätzungen
  • Discounted Cashflow: erstellt Fair-Value Diagramme mit beliebigen Abzinsungsfaktor

Die Linkadressen der Grafiken werden in die Zwischenablage kopiert durch: Rechtsklick auf den Link ➔ Adresse des Links kopieren

Beim Schreiben eines neues Themas kann einfach dieser Link unter „Bild einfügen“ ➔ „Quelle“ hinzugefügt werden.

Hinzufügen von Grafiken als Chart-API Link

Das Ergebnis sieht dann folgendermaßen aus:

Forum-Beitrag mit eingebetteter Grafik, die täglich aktualisiert wird