\name{getFinancials}
\alias{getFinancials}
\alias{viewFinancials}
\alias{getFin}
\alias{viewFin}
\title{ Download and View Financial Statements }
\description{
Download Income Statement, Balance Sheet, and
Cash Flow Statements from Google Finance.
}
\usage{
getFinancials(Symbol, env = .GlobalEnv, src = "google", 
              auto.assign = TRUE,
              ...)

viewFinancials(x, type=c('BS','IS','CF'), period=c('A','Q'),
               subset = NULL)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
  \item{Symbol}{ a valid google symbol }
  \item{env}{ where to create the object }
  \item{src}{ currently unused }
  \item{auto.assign}{ should results be loaded to the environment }
  \item{\dots}{ currently unused }
  \item{x}{ an object of class financials }
  \item{type}{ type of statement to view }
  \item{period}{ period of statement to view }
  \item{subset}{ \sQuote{xts} style subset string }
}
\details{
A utility to download financial statements for
publically traded companies. The data is directly
from Google finance.  All use of the data is
under there Terms of Service, available at
\url{http://www.google.com/accounts/TOS}.

Individual statements can be accessed using
standard \R list extraction tools, or by
using \code{viewFinancials}.

\code{viewFinancials} allows for the use of
date subsetting as available in the \pkg{xts}
package, as well as the specification of
the type of statement to view. BS for balance
sheet, IS for income statement, and CF for cash flow
statement. The period argument is used to identify
which statements to view - (A) for annual and (Q)
for quarterly.
}
\value{
  Six individual matricies organized in a list of class \sQuote{financials}:
  \item{ IS }{ a list containing (Q)uarterly and (A)nnual Income Statements }
  \item{ BS }{ a list containing (Q)uarterly and (A)nnual Balance Sheets }
  \item{ CF }{ a list containing (Q)uarterly and (A)nnual Cash Flow Statements }
}
\references{ Google Finance BETA: \url{http://finance.google.com/finance}}
\author{ Jeffrey A. Ryan }
\note{
As with all free data, you may be getting exactly what you pay for.
}
\examples{
\dontrun{
JAVA <- getFinancials('JAVA')
AAPL <- getFin('AAPL')

JAVA$IS$Q   # Quarterly Income Statement
AAPL$CF$A   # Annual Cash Flows

str(AAPL)
}
}
\keyword{ utilities }
