NAME

Finance::QuoteHist::Yahoo::Australia - Site-specific subclass for retrieving historical stock quotes.

SYNOPSIS

  use Finance::QuoteHist::Yahoo::Australia;
  $q = Finance::QuoteHist::Yahoo::Australia->new(
    symbols    => [qw(BHP.AX)],
    start_date => '01/01/1999',
    end_date   => 'today',
  );

  # Values
  foreach $row ($q->quotes()) {
    ($symbol, $date, $open, $high, $low, $close, $volume) = @$row;
    ...
  }

  # Splits
  foreach $row ($q->splits()) {
     ($symbol, $date, $post, $pre) = @$row;
  }

  # Dividends
  foreach $row ($q->dividends()) {
     ($symbol, $date, $dividend) = @$row;
  }

DESCRIPTION

Finance::QuoteHist::Yahoo::Australia is a subclass of Finance::QuoteHist::Yahoo, specifically tailored to read historical quotes, dividends, and splits from the Yahoo Australia web site (http://au.finance.yahoo.com/).

Please see Finance::QuoteHist::Yahoo(3) for more details on usage and available methods. If you just want to get historical quotes and are not interested in the details of how it is done, check out Finance::QuoteHist(3).

METHODS

The basic user interface consists of three methods, as seen in the example above. Those methods are:

quotes()

Returns a list of rows (or a reference to an array containing those rows, if in scalar context). Each row contains the Symbol, Date, Open, High, Low, Close, and Volume for that date.

dividends()

Returns a list of rows (or a reference to an array containing those rows, if in scalar context). Each row contains the Symbol, Date, and amount of the Dividend, in that order.

splits()

Returns a list of rows (or a reference to an array containing those rows, if in scalar context). Each row contains the Symbol, Date, Post split shares, and Pre split shares, in that order.

REQUIRES

Finance::QuoteHist::Yahoo

DISCLAIMER

The data returned from these modules is in no way guaranteed, nor are the developers responsible in any way for how this data (or lack thereof) is used. The interface is based on URLs and page layouts that might change at any time. Even though these modules are designed to be adaptive under these circumstances, they will at some point probably be unable to retrieve data unless fixed or provided with new parameters. Furthermore, the data from these web sites is usually not even guaranteed by the web sites themselves, and oftentimes is acquired elsewhere.

If you would like to know more, check out the terms of service from Yahoo!, which can be found here:

  http://au.docs.yahoo.com/info/terms/

If you still have concerns, then use another site-specific historical quote instance, or none at all.

Above all, play nice.

AUTHOR

Matthew P. Sisk, <sisk@mojotoad.com>

COPYRIGHT

Copyright (c) 2010 Matthew P. Sisk. All rights reserved. All wrongs revenged. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Finance::QuoteHist::Yahoo(3), Finance::QuoteHist::Generic(3), Finance::QuoteHist(3), perl(1).