Brian-Egan / sheets-coins

Adds super easy cryptocurrency (Bitcoin, Bitcoin Cash, Ripple, Ethereum, Litecoin) price lookups and calculator functions to Google Sheets.

Google Sheets -> Cryptocurrency Price Lookup

Version 3

Auto-update timer The first time you close & re-open your spreadsheet after adding this code, a new "Cryptos Update" menu will appear with two options: "Refresh" and "Add auto-update timer". Due to the way Google Sheets works with external requests and custom functions, you must select "Add auto-update timer" before "Refresh" or any auto-updates will work.

Select "Add auto-update timer" and a new background tab titled "Timer" will be added to your sheet. You can ignore (but do not delete) this. After the initial setup, simple auto_update as the final argument to all the functions listed below. They will update every 5 minutes like magic!

e.g. =getPrice("Ripple", auto_update) or =getPrices(auto_update)

After this setup, selecting Refresh from the Cryptos Update menu will trigger an automatic update of prices.

Explanation: If you're curious why I set it up this way - it's due to the limitations Google Sheets puts on custom formulas. They will only update when one of the formulas arguments change. We force the update by referencing the auto-updating timer added above in our =getPrices() formula.

V2 Functions

Added support for Ripple!

V1

This adds three functions to your Google Sheet - =getPrice(), =getValue(), and =getPrices().

• getPrice takes a cryptocurrency name or cell containing a crytocurrency and returns it's current price.

• getValue takes a cryptocurrency name, a quantity of that currency, and (optional) national currency and type ("buy"/"sell") and returns the value of that cryptocurrency.

• getPrices returns a grid containing the current buy and sell prices for 4 cryptocurrencies (Bitcoin, Bitcoin Cash, Ethereum, Litecoin).

All prices update automatically with your spreadsheet (default is ~1 minute).

How to install

1. Open a Google Sheet, and on the menu bar select Tools and then Script Editor.
2. A new script editor window opens. In this window, copy/paste the contents of cryptos.gs.
3. Call =getPrice(), =getValue(), and =getPrices() in your sheet! See examples below.

Usage and Examples

getPrice()

=getPrice(cryptocurrency, type, currency)

• cryptocurrency can be either a cell reference containing the name, the name, or it's symbol abbreviation. (i.e. "ETH" for "Ethereum")
• type is "buy", "sell", or "spot"
• currency is a physical currency to convert. (i.e. "USD" for US. Dollars, "GPB" for British Pounds, etc..)

getValue()

=getValue(cryptocurrency, amount, currency, type)

• cryptocurrency can be either a cell reference containing the name, the name, or it's symbol abbreviation. (i.e. "ETH" for "Ethereum")
• amount is the quantity of that crypt you want to convert.
• type is "buy", "sell", or "spot"
• currency is a physical currency to convert. (i.e. "USD" for US. Dollars, "GPB" for British Pounds, etc..)

getPrices()

=getPrices() Returns a grid with current prices for 4 cryptocurrencies.

Questions? Comments? Ask me!