Moder­ne Broker-Portale bie­ten einem Inves­tor die Mög­lich­keit, Kur­se sei­ner Akti­en bzw. Optio­nen abzu­ru­fen. Dort fin­det er in der Regel auch Kurs-Charts und Chart-Analyse-Kurven zu den unter­schied­lichs­ten Zeit­räu­men. Dem ein oder ande­ren pri­va­ten Inves­tor sind die­se Ana­ly­sen viel­leicht nicht aus­rei­chend genug. Es mag unter ihnen Infor­ma­ti­ker und Hobby-Programmierer geben, die den Wunsch äußern, mit Kurs­da­ten mathe­ma­ti­sche Ana­ly­sen durch­zu­füh­ren, um Indi­ka­to­ren selbst zu berech­nen. Nur wie gelangt ein Pro­gram­mie­rer an die aktu­el­len und his­to­ri­schen Zah­len ein­zel­ner Akti­en­kur­se? Die­ser Bei­trag soll die Mög­lich­kei­ten der Yahoo!Finance-Schnittstelle näher bringen.
Für das Ermit­teln unter­schied­li­cher Kurs­da­ten bie­tet Yahoo!Finance (auch für Deutsch­land) ver­schie­de­ne CSV-Export-Services an. CSV steht für “Com­ma Sepa­ra­ted Values” und bedeu­tet hier nichts ande­res, als dass die gan­zen Kenn­zah­len (wie z.B. Schluss-Kurs oder Volu­men) in rei­ner Text­form mit Kom­mas und Zei­len­um­brü­chen getrennt aus­ge­lie­fert wer­den. Daten in solch einem For­mat kann ein Com­pu­ter­pro­gramm für Ana­ly­se­zwe­cke leicht ver­ar­bei­ten. Im Fol­gen­den wer­den die bekann­ten Schnitt­stel­len genau­er erläu­tert und dazu pas­sen­de Bei­spie­le und PHP-Scripte prä­sen­tiert. Da mir kei­ne offi­zi­el­le API von Yahoo!Finance bekannt ist und ich die hier beschrie­be­ne Schnitt­stel­le durch Aus­pro­bie­ren und Stu­di­um ermit­telt habe, kann ich für eine Voll­stän­dig­keit des auf­ge­zeig­ten Funk­ti­ons­um­fan­ges nicht garan­tie­ren. Für Hin­wei­se bin ich daher sehr dank­bar. Ver­wen­det ein Ent­wick­ler die Ser­vices von Yahoo!Finance, so soll­te er sich vor­her die Nut­zungs­be­din­gun­gen (sie­he auch) genau durchlesen.

Aktuelle Kursdaten ermitteln

Ganz ehr­lich, “aktu­ell” bedeu­tet bei der kos­ten­lo­sen Yahoo!Finance-Schnittstelle lei­der eine Ver­zö­ge­rung von 15 Minu­ten für NASDAQ Wer­te, bis hin zu 60 Minu­ten für ande­re Bör­sen­plät­ze (nähe­res auf Yahoo!Finance). Doch für die meis­ten Ver­wen­dungs­zwe­cken bzw. west­li­chen Bör­sen­kur­se dürf­te die­se Ver­zö­ge­rung kein Pro­blem dar­stel­len. Yahoo! bie­tet Kur­se aus den unter­schied­lichs­ten Bör­sen­plät­zen an. Die Selek­ti­on des ent­spre­chen­den Han­dels­plat­zes fin­det in der URL selbst, sowie in einem Anhang (Suf­fix) an der Sym­bol­an­ga­be statt. Im Kapi­tel “Län­der­un­ter­schie­de” wer­den die Unter­schie­de auf­ge­lis­tet. Zum bes­se­ren Ver­ständ­nis zei­ge ich hier nur die Basis-URL, wel­che vor allem für die US-Börsenkurse gül­tig ist. Das Ergeb­nis ist eine Wer­te­lis­te, die durch Kom­mas getrennt prä­sen­tiert wird. Die Ser­vice­adres­sen für aktu­el­le Kurs­in­for­ma­tio­nen lau­tet http://finance.yahoo.com/d/quotes.csv? (alter­na­tiv http://download.finance.yahoo.com/d/quotes.csv?) und nimmt die fol­gen­den drei bekann­ten Para­me­ter entgegen:

Das fol­gen­de Bei­spiel ermit­telt von Apple und Micro­soft das Sym­bol, den Firmen-Namen, den aktu­el­len Anfrage-Kurs und die dazu gehö­ri­ge Zeit ab. Dabei sind Zeit und Kurs­wert immer län­der­spe­zi­fisch zu ver­ste­hen (US-Zeit und Dol­lar). Wenn Sie die­se URL in den Brow­ser ein­ge­ben, kön­nen Sie das Ergeb­nis abspei­chern. Danach kön­nen Sie die Roh­da­ten in einem Text­edi­tor öff­nen und betrach­ten (nicht mit Excel öff­nen, da hier die For­ma­tie­rung nicht ersicht­lich wird).

http://finance.yahoo.com/d/quotes.csv?s=AAPL+MSFT&f=snat1
---
"AAPL","APPLE INC",151.47,"3:31pm"
"MSFT","MICROSOFT CP",29.09,"3:31pm"

Ein Pro­gramm kann nun die­se Daten in einem mehr­di­men­sio­na­len Array able­gen. Dabei ent­hal­ten die Spal­ten die Inhal­te der Wer­te, wel­che durch die Format-Codes ange­for­dert wur­den. Die Zei­len bil­den jeweils das Zah­len­tu­pel eines Wert­pa­piers ab. Eine PHP-Funktion zur Ermitt­lung der Kurs­da­ten könn­te somit fol­gen­der­ma­ßen aussehen:

<?php
    /*
     * Getting current quotes:
     * Reading multible lines of values into an array depending on the given symbols and function tags.
     * Each line holds the values of one symbol. In the argument, symbols are separated by "+".
     *
     * (c) Matthias Brusdeylins, 2008
     * License: CC-GNU GPL (http://creativecommons.org/licenses/GPL/2.0/)
     */    
    define ("QUOTES_URL", "http://finance.yahoo.com/d/quotes.csv?");
    function loadYahooQuotes ($symbol,
                              $tags)
    {
        $lineCount = 0;
        $stocks = array();
        // load the stock quotes: we are opening it for reading
        // http://finance.yahoo.com/d/quotes.csv?s=  STOCK SYMBOLS  &f=  FORMAT TAGS
        $URL = QUOTES_URL."s=$symbol&f=$tags&e=.csv";
        $fileHandle = fopen ($URL,"r");
        if ($fileHandle) {
            // use the fgetcsv function to store quote values into an array $lineValues
            // one symbol in one line
            do {
                $stockValues = fgetcsv ($fileHandle, 999999, ",");
                if ($stockValues) {
                    $lineCount++;
                    $stocks[$lineCount] = $stockValues;
                }
            } while ($stockValues);
        fclose ($fileHandle);
        } else {
            // ERROR-Message in the array
            $stocks[0][0] = "ERROR";
            $stocks[0][1] = "No data found.";
        }
        return $stocks;
    }
?>

Devisen

Sie kön­nen nicht nur ein­zel­ne Akti­en­kur­se erfra­gen, son­dern auch Devi­sen­kur­se. Dazu müs­sen Sie an der oben vor­ge­stell­ten Adres­se als Symbol-Parameter ein spe­zi­el­les Kon­strukt der Form AB=X über­mit­teln. Hier steht der Buch­sta­be A für die ers­te zu ver­glei­chen­de Wäh­rung und der Buch­sta­be B dann natür­lich für die zwei­te Wäh­rung. X steht wohl für Exchan­ge und wird nicht ersetzt. Wol­len Sie meh­re­re Wäh­run­gen abfra­gen, kön­nen meh­re­re Kon­struk­te mit­tels dem Plus­zei­chen “+” anein­an­der gehängt wer­den. Fol­gen­des Bei­spiel soll dies verdeutlichen:

http://quote.yahoo.com/d/quotes.csv?s=USDCAD=X+JPYUSD=X&f=nl1d1t1
---
"USD to CAD",1.0088,"4/4/2008","5:02pm"
"JPY to USD",0.0098,"4/4/2008","5:26pm"

Die Kür­zel der Wäh­run­gen bestehen aus drei Buch­sta­ben und wer­den hier aufgelistet:

Die Format-Codes

Für den Para­me­ter der Formate-Codes (”f”) ste­hen eine gan­ze Rei­he akzep­tier­ter Format-Tags zur Ver­fü­gung. Vie­le sind dabei wohl red­un­dant und wer­den hier ein­fach zusam­men­ge­fasst (z.B. “a” und “b2″ für Anfrage-Kurs). Die fol­gen­de Tabel­le lis­tet alle bekann­ten Codes auf.
Ach­tung: In eini­gen Fäl­len lie­fert Yahoo!Finance mehr­stel­li­ge Wer­te zurück, die eben­falls mit Kom­mas getrennt dar­ge­stellt wer­den. Dies ist an sich unge­schickt, da es für Sie als Pro­gram­mie­rer schwie­rig wird, die Kom­mas zwi­schen den ein­zel­nen Wer­ten von den Kom­mas in einem Wert zu unter­schei­den. Hier emp­feh­le ich, die­se Para­me­ter getrennt abzufragen.

Höhe­re Index­wer­te füh­ren nur noch zu einer Wie­der­ho­lung der Inhal­te. Ver­mut­lich sol­len die Codes zwei­stel­lig sein (Buch­sta­be + Zahl). Fällt die Zahl weg, so wir auto­ma­tisch der Index 0 angenommen.

Daytrading-Daten

Lei­der bie­tet Yahoo!Finance nur die letz­ten 100 Tages-Kurswerte zum Ermitt­lungs­zeit­punkt an. Auch hier wirkt die Ver­zö­ge­rung von 15–60 Minu­ten, wie im Abschnitt “Aktu­el­le Kurs­da­ten” beschrie­ben. Die Ser­vice­adres­se für die Daytrading-Daten lau­tet http://logtrade.finance.vip.ukl.yahoo.com/lastTrades? und nimmt fol­gen­de drei bekann­te Para­me­ter entgegen:

Das Ergeb­nis einer sol­chen Abfra­ge lie­fert eine Lis­te mit Wer­te­grup­pen — eine Grup­pe für jeden Tra­de. Ein sol­ches Tupel ent­hält den Trading-Zeitpunkt, den Kurs­wert und die Volu­mi­na des Trades.

Historische Kursdaten

Für ein Wert­pa­pier ste­hen bei Yahoo eben­falls his­to­ri­sche Daten zur Ver­fü­gung. Die Service-URL hier­für lau­tet http://ichart.finance.yahoo.com/table.csv? (alter­na­tiv: http://real-chart.finance.yahoo.com/table.csv?) und besitzt Para­me­ter für das Sym­bol, sowie für das Zeit­in­ter­vall, inner­halb ein Ent­wick­ler die täg­li­chen bzw. wöchent­li­chen Kurs­da­ten ermit­teln will:

Das Ergeb­nis besteht aus einer Lis­te täg­li­cher, wöchent­li­cher oder monat­li­cher Wer­te zu dem über­mit­tel­ten Zeit­raum. Die ers­te Zei­le ent­hält die Über­schrift der ein­zel­nen Spal­ten­wer­te. In allen wei­te­ren Zei­len lie­fert Yahoo!Finance danach das Datum, den Eröff­nungs­kurs, den höchs­ten und tiefs­ten Kurs­wert, sowie den Tages­schluss­kurs und das Han­dels­vo­lu­men für jeden ein­zel­nen Tag. Da die­se Wer­te gegen­über Splits und Divi­den­den unbe­rei­nigt sind, lie­fert Yahoo! in der letz­ten Spal­te “Adj. Clo­se” noch berei­nig­te Schluss­kur­se. Ein biss­chen anders sieht das Ergeb­nis aus, wenn als Chart-Abstufung der Wert “v” für die Divi­den­den­aus­schüt­tun­gen ange­ge­ben wird. Dann wer­den nur noch zwei Spal­ten mit einem Datum sowie dem Wert selbst zurück­ge­lie­fert. Hier noch zwei Bei­spie­le mit den ers­ten paar Zei­len der Ergebnisse:

http://ichart.finance.yahoo.com/table.csv?s=AAPL&d=3&e=3&f=2008&g=d&a=8&b=7&c=1984&ignore=.cvs
---
Date,Open,High,Low,Close,Volume,Adj Close
2008-04-02,148.78,151.20,145.85,147.49,37253700,147.49
2008-04-01,146.30,149.66,143.61,149.53,36846400,149.53
2008-03-31,143.27,145.71,142.52,143.50,27418300,143.50
2008-03-28,141.80,144.65,141.60,143.01,25521800,143.01
...

http://itable.finance.yahoo.com/table.csv?s=AAPL&d=3&e=3&f=2008&g=v&a=8&b=7&c=1984&ignore=.cvs
---
Date,Dividends
1995-11-21,0.030000
1995-08-16,0.030000
1995-05-26,0.030000
...

Für die pro­gram­ma­ti­sche Aus­wer­tung die­ser Daten bie­tet sich auch hier das Array als Ergeb­nis­trä­ger an. In jeder Zei­le kön­nen so die Wer­te eines Tages (bzw. einer Woche, eines Monats oder der Divi­den­den) abge­legt wer­den. Fol­gen­de PHP-Funktion soll dies verdeutlichen:

<?php
    /*
     * Getting historical quotes in a given time period
     * Parameters:
     * $symbol:                             symbol
     * $startDay, $startMonth, $startYear:  the first day for the historical quotes
     * $endDay, $endMonth, $endYear:        the last day for the historical quotes
     * $step  (d/w/m/v):                    d=daily, w=weekly, m=monthly, v=dividends
     *
     * (c) Matthias Brusdeylins, 2008
     * License: CC-GNU GPL (http://creativecommons.org/licenses/GPL/2.0/)
     */
    define ("HISTORY_QUOTES_URL", "http://ichart.yahoo.com/table.csv?");
    function loadHistoricalYahooQuotes ($symbol,
                                        $startDay,
                                        $startMonth,
                                        $startYear,
                                        $endDay,
                                        $endMonth,
                                        $endYear,
                                        $step)
    {
        $lineCount = 0;
        $days = array();
        // modify parameters
        $sM=$startMonth-1;
        $eM=$endMonth-1;
        // load the historical stock quotes: we are opening it for reading
        // http://ichart.yahoo.com/table.csv?s=  SYMBOL.COUNTRY  &a,b,c START $d,e,f ENDE $g d=daily/w=weekly/m=monthly/v=dividends
        $URL = HISTORY_QUOTES_URL."s=$symbol&a=$sM&b=$startDay&c=$startYear&d=$eM&e=$endDay&f=$endYear&g=$step&y=0&ignore=.cvs";
        $fileHandle = fopen ($URL,"r");
        if ($fileHandle) {
            // use the fgetcsv function to store quote values into a array $lineValues
            // store one symbol in one line
            do {
                $stockValues = fgetcsv ($fileHandle, 999999, ",");
                if ($stockValues) {
                    $lineCount++;
                    $days[$lineCount] = $stockValues;
                }
            } while ($stockValues);
            // close handle
            fclose ($fileHandle);
        } else {
            $days[0][0] = "ERROR";
            $days[0][1] = "No data found.";
        }        
        return $days;
    }
?>

Länderunterschiede

An der Bör­se wer­den nicht nur Akti­en in unter­schied­li­chen Wäh­run­gen gehan­delt, son­dern auch Neben­wer­te wie bei­spiels­wei­se Opti­ons­schei­ne. Der Han­del sol­cher Wert­pa­pie­re ist meist auf ein Land bzw. Bör­sen­platz beschränkt. Aus die­sem Grund bie­tet Yashoo!Finance auch unter­schied­li­che Ser­vice­adres­sen an. In die­sem Arti­kel wur­den bis­her nur die Adres­sen für US-Börsendaten auf­ge­zeigt. So kann unter der URL http://finance.yahoo.com/d/quotes.csv? der aktu­el­le Kurs einer Aktie in US-Dollars ermit­telt wer­den. Wol­len Sie hin­ge­gen einen Kurs aus dem deut­schen Raum ermit­teln, steht Ihnen die URL http://de.finance.yahoo.com/d/quotes.csv? zur Verfügung.
Die fol­gen­de Tabel­le zeigt die Adres­sen (URL) zum Yahoo!Finance-Service für aktu­el­le Bör­sen­kur­se. In der ers­ten Spal­te wer­den auch die Symbol-Suffixe auf­ge­lis­tet, wel­che für eine akti­ve Börsenplatz-Wahl an die Sym­bol­an­ga­be gehängt wer­den kön­nen (z.B. “AAPL.DE” für den XETRA-Kurs des Apple-Aktie). Ein Besuch auf die Web­sei­te von Yahoo! Finan­ce hilft hier bei der Aus­wahl der rich­ti­gen Symbolbezeichnung.

Download

Die Klas­se Finance_API_Yahoo bie­tet einen ein­fa­chen Zugriff auf die hier beschrie­be­ne Schnitt­stel­le. Mit ihr las­sen sich aktu­el­le, sowie his­to­ri­sche Kurs­da­ten ermit­teln. Das Ergeb­nis wird in einem zwei­di­men­sio­na­len Array zurück­ge­lie­fert (sie­he Bei­spie­le im Text). Für die Package-Struktur dien­te das Zend-Framework als Vor­la­ge. Somit ist eine ein­fa­che Inte­gra­ti­on in die­ses gewährleistet.
Yahoo! Finan­ce API, Ver­si­on 1.0

Change-Log

 

Die­se Soft­ware und die hier gezeig­ten Code­stü­cke fal­len unter den Lizenz­ver­trag CC-GNU GPL.