1/15/22, 1:55 PM GOOGLEFINANCE - Docs Editors Help

GOOGLEFINANCE
Fetches current or historical securities information from Google Finance.

Sample Usage
GOOGLEFINANCE("NASDAQ:GOOG", "price", DATE(2014,1,1), DATE(2014,12,31), "DAILY")

GOOGLEFINANCE("NASDAQ:GOOG","price",TODAY()-30,TODAY())

GOOGLEFINANCE(A2,A3)

Syntax
GOOGLEFINANCE(ticker, [attribute], [start_date], [end_date|num_days], [interval])

• ticker - The ticker symbol for the security to consider. It’s mandatory to use both the exchange symbol and ticker
symbol for accurate results and to avoid discrepancies. For example, use “NASDAQ:GOOG” instead of “GOOG.”

• If the exchange symbol is not specified, GOOGLEFINANCE will use its best judgement to choose one for you.

• Note: Reuters Instrument Codes are no longer supported. For example, use TSE:123 or ASX:XYZ instead of ticker
123.TO or XYZ.AX.

• attribute - [ OPTIONAL - "price" by default ] - The attribute to fetch about ticker from Google Finance and is
required if a date is specified.

• attribute is one of the following for real-time data:

• "price" - Real-time price quote, delayed by up to 20 minutes.

• "priceopen" - The price as of market open.

• "high" - The current day's high price.

• "low" - The current day's low price.

• "volume" - The current day's trading volume.

• "marketcap" - The market capitalization of the stock.

• "tradetime" - The time of the last trade.

• "datadelay" - How far delayed the real-time data is.

• "volumeavg" - The average daily trading volume.

• "pe" - The price/earnings ratio.

• "eps" - The earnings per share.

• "high52" - The 52-week high price.

• "low52" - The 52-week low price.

• "change" - The price change since the previous trading day's close.

• "beta" - The beta value.

• "changepct" - The percentage change in price since the previous trading day's close.

• "closeyest" - The previous day's closing price.

• "shares" - The number of outstanding shares.

• "currency" - The currency in which the security is priced. Currencies don't have trading windows, so open,
low, high, and volume won't return for this argument.

• attribute is one of the following for historical data:

• "open" - The opening price for the specified date(s).

• "close" - The closing price for the specified date(s).

• "high" - The high price for the specified date(s).

• "low" - The low price for the specified date(s).

• "volume" - The volume for the specified date(s).

https://support.google.com/docs/answer/3093281?hl=en 1/4
1/15/22, 1:55 PM GOOGLEFINANCE - Docs Editors Help
• "all" - All of the above.

• attribute is one of the following for mutual fund data:

• "closeyest" - The previous day's closing price.

• "date" - The date at which the net asset value was reported.

• "returnytd" - The year-to-date return.

• "netassets" - The net assets.

• "change" - The change in the most recently reported net asset value and the one immediately prior.

• "changepct" - The percentage change in the net asset value.

• "yieldpct" - The distribution yield, the sum of the prior 12 months' income distributions (stock dividends and
fixed income interest payments) and net asset value gains divided by the previous month's net asset value
number.

• "returnday" - One-day total return.

• "return1" - One-week total return.

• "return4" - Four-week total return.

• "return13" - Thirteen-week total return.

• "return52" - Fifty-two-week (annual) total return.

• "return156" - 156-week (3-year) total return.

• "return260" - 260-week (5-year) total return.

• "incomedividend" - The amount of the most recent cash distribution.

• "incomedividenddate" - The date of the most recent cash distribution.

• "capitalgain" - The amount of the most recent capital gain distribution.

• "morningstarrating" - The Morningstar "star" rating.

• "expenseratio" - The fund's expense ratio.

• start_date - [ OPTIONAL ] - The start date when fetching historical data.

• If start_date is specified but end_date|num_days is not, only the single day's data is returned.
• end_date|num_days - [ OPTIONAL ] - The end date when fetching historical data, or the number of days from
start_date for which to return data.

• interval - [ OPTIONAL ] - The frequency of returned data; either "DAILY" or "WEEKLY".

• interval can alternatively be specified as 1 or 7. Other numeric values are disallowed.

Notes
Usage restrictions: The data is not for financial industry professional use or use by other professionals at non-financial
firms (including government entities). Professional use may be subject to additional licensing fees from a third-party
data provider.

• All parameters must be enclosed in quotation marks or be references to cells containing text. 

Note: A possible exception is when interval is specified as a number and when end_date|num_days is specified
as a number of days.

• Real-time results will be returned as a value within a single cell. Historical data, even for a single day, will be
returned as an expanded array with column headers.

• Some attributes may not yield results for all symbols.

• If any date parameters are specified, the request is considered historical and only the historical attributes are
allowed.
• GOOGLEFINANCE is only available in English and does not support most international exchanges.

• Historical data cannot be downloaded or accessed via the Sheets API or Apps Script. If you attempt to do so, you'll
see a #N/A error in place of the values in the corresponding cells of your spreadsheet.

• Quotes are not sourced from all markets and may be delayed up to 20 minutes. Information is provided 'as is'
and solely for informational purposes, not for trading purposes or advice.

• Dates passed into GOOGLEFINANCE are treated as noon UTC time. Exchanges that close before that time may be
shifted by a day.

https://support.google.com/docs/answer/3093281?hl=en 2/4
1/15/22, 1:55 PM GOOGLEFINANCE - Docs Editors Help

Examples
Make a copy

Note: Each example is in its own tab.

General usage
Retrieves market information from Google Finance.

GoogleFinance : General Usage

Result Formula
151.94 =GoogleFinance("NYSE:DIS")
151.94 =GoogleFinance("NYSE:DIS", "price")
=GoogleFinance(NYSE:"DIS",
16831957 "volume")
1.19 =GoogleFinance("NYSE:DIS", "beta")

>
General Usage
<

Common attributes
GoogleFinance : Common Attributes
symbol NYSE:DIS

attribute Result Formula

price 151.94 =GoogleFinance($B$1,A5)
priceopen 152.35 =GoogleFinance($B$1,A6)
high 152.62 =GoogleFinance($B$1,A7)
low 148.42 =GoogleFinance($B$1,A8)
volume 16831957 =GoogleFinance($B$1,A9)
marketcap 276174505137 =GoogleFinance($B$1,A10)
tradetime 44575.66823 =GoogleFinance($B$1,A11)
datadelay 0 =GoogleFinance($B$1,A12)
volumeavg 10910283 =GoogleFinance($B$1,A13)
pe 137 23 =GoogleFinance($B$1 A14)
>
Common Attributes
<

Historical market data

Retrieves historical market information based on the specified dates from Google Finance.

GoogleFinance : Historical Market Data

symbol NASDAQ:GOOG
attribute high
start_date 1/1/2012
num_days or
30
end_date
interval 7

Result Formula
Date High =GoogleFinance($B$1,$B$2,$B$3,$B$4,$
40914.66667 335.12
40921.66667 323.5
40928.66667 320.49
40935 66667 294 32
>
Historical Market Data
<

Mutual funds

https://support.google.com/docs/answer/3093281?hl=en 3/4
1/15/22, 1:55 PM GOOGLEFINANCE - Docs Editors Help
Common attributes for mutual funds.

GoogleFinance : Attributes For Mutual Funds

symbol MUTF:FCNTX

attribute Result Formula

closeYest 17.88 =GoogleFinance($B$1,A5)
date 44575 =GoogleFinance($B$1,A6)
returnytd 4.49 =GoogleFinance($B$1,A7)
netassets 91385092867 =GoogleFinance($B$1,A8)
change 0.04 =GoogleFinance($B$1,A9)
changepct 0.22 =GoogleFinance($B$1,A10)
yieldpct 0.08 =GoogleFinance($B$1,A11)
returnday -0.4 =GoogleFinance($B$1,A12)
return1 -2.55 =GoogleFinance($B$1,A13)
return4 59 =GoogleFinance($B$1 A14)
>
Attributes For Mutual Funds
<

Currency exchange trends

Creates a chart inside a cell to display the currency exchange trend during the last 30 days, using the retrieving result
returns by GoogleFinance.

GoogleFinance : Currency Exchange Trends

Base Currency Days
USD 30

Compared
Currency Trend
EUR =SPARKLINE(GoogleFinance("C
AUD =SPARKLINE(GoogleFinance("C
CAD =SPARKLINE(GoogleFinance("C
GBP =SPARKLINE(GoogleFinance("C
=SPARKLINE(GoogleFinanc
CNY
=SPARKLINE(GoogleFinanc
JPY

>
Currency Exchange Trends
<

https://support.google.com/docs/answer/3093281?hl=en 4/4