A collection of Google Apps Script custom functions for tracking crypto portfolios in Google Sheets.

The price data is pulled using CoinGecko's API, and the token balances are obtained by making queries to various RPC servers like PublicNode.

If this project helped you, consider buying me a coffee via 3Cities or GitHub Sponsors.

1. Obtain a CoinGecko Demo API by following the instructions here.
2. Open the Cryptfolio template in Google Sheets.
3. Click on "File", and then "Make a copy". This will create a copy of the template in Google Sheets.
4. From the toolbar, click on "Extensions", and then on "Apps Script". You should be able to see the code now.
5. Add the chains and tokens you want to track in the ChainId and Token objects in data.gs.
6. Query the price data by running the GET_ALL_PRICES function.
7. Use the GET_ERC20_BALANCE and GET_NATIVE_BALANCE functions to query your holdings in real-time.
8. Calculate the USD value of your holdings by reading the local price data with INDEX and MATCH.

The template shows how to query balances for ARB, ETH, MKR, and OP, and how to calculate the values of the holdings:

I built this because I was frustrated with the existing solutions, which are either too complex, too expensive, or too unstable.

Cryptfolio is:

• Free to use
• Minimalist
• DYI and easy to customize
• Functional; it just works

This project is meant to be forked and customized to your needs. Here are two common use cases:

To track a new chain:

• Add it to the ChainId object in data.gs.
• Add the corresponding RPC URL to the RpcUrl object.
• Optionally add chain name mappings to the ChainNameMap object for easier reference.

To track a new token:

• List it in the Data:Prices sheet in the spreadsheet. Ensure that the COIN_IDS range got updated, too.
• Add the token to the Token object in data.gs with its contract address and decimals.
• For multi-chain tokens, use the chain-specific structure (see examples like USDC or DAI).

Here's a table with the custom functions enabled by this project.

The Read functions can be called from either Google Sheets or Apps Script, but the Write functions can only be run from within the Apps Script environment. This is because a custom function cannot affect cells other than those it returns a value to.

Feel free to dive in! Open an issue, start a discussion or submit a PR.

This project couldn't exist without the CoinGecko API. Thank you for providing such a valuable service for free!

This project is licensed under MIT.