👉 IMPORTANT - UPDATED 2/1/2021 TO INCLUDE PRICEA EXAMPLES (PLEASE SEE BELOW)
OVERVIEW
Any custom function, data set or endpoint accessible in Cryptosheets can easily and automatically be refreshed or updated at any custom interval in Excel or Googlesheets* using one single formula. The formulas are slightly different in Excel vs Googlesheets and there are limitations in Googlesheets, there are none in Excel.
Automatic refresh is available to paid subscriptions (hobbyist and up*)
This article covers:
How Does It Work?
Example Use Cases
How to Upgrade Your Subscription
FAQ & Troubleshooting
❓ HOW DOES IT WORK?
👉 UPDATED 2/1/2021
With the introduction of the PRICEA custom function (advanced version of the original PRICE function) the best practice for using CS.TIME as an invocation refresh trigger is as follows
Excel
Type
=CS.TIME(# of seconds)
into any cell (ie $A$1)
Example=CS.TIME(3600)
👉 3600 seconds / 60 = 60 minutes = 1 hour
Using any Cryptosheets custom function, add a reference to a parameter called
refresh
with a value of=CS.TIME
in it as the parameter value or a reference to a cell with CS.TIME in it (see example below)
Syntax Example 1
=CSPRICEA("base","BTC","quote","USD","refresh",CS.TIME(3600))
Syntax Example 2
=CSPRICEA("base","BTC","quote","USD","refresh",$C$5)
Excel (DEPRECATED EXAMPLES)
Type
=CS.TIME(# of seconds)
into any cell (ie $A$1)
Example=CS.TIME(3600)
👉 3600 seconds / 60 = 60 minutes = 1 hour
(DEPRECATED) Using any Cryptosheets custom function, add a reference to the cell with
=CS.TIME
in it as thetime
parameter or at the very end of the formula if there isn't atime
parameter
Syntax=CSPRICE("base","quote","time","exchange","returnType")
Example=CS.PRICE("BTC","USD",$A$1)
Example 2=CS.PRICE("BTC","USD",CS.TIME(3600))
Every time the
=CS.TIME
function updates, any/all functions that reference it will automatically refresh!
Googlesheets
In any cell (ie $A$1) type
=GOOGLEFINANCE("CURRENCY:USDEUR")
which will automatically update (about every 2 minutes)
Using any Cryptosheets custom function, add a reference to that cell at the very end of the formula for the global
refresh
argument
Syntax=CSPRICE("base","quote","time","exchange","returnType","refresh")
Example=CSPRICE("BTC","USD",,,$A$1)
ExampleCSPRICE("BTC","USD",,,GOOGLEFINANCE("CURRENCY:USDEUR"))
Everytime the GoogleFinance cell updates 👉 so will your Cryptosheets data! That's it!
TIP
Just be aware of your Cryptosheets account subscription limits Google's quotas and limits as your data will stop refreshing if you run too many requests
📈 EXAMPLE USE CASES
So many here can only cover a few
trading
arbitrage
recurring charts, reports/
😎 HOW TO UPGRADE YOUR SUBSCRIPTION
Very easy and can be done anytime from within the Cryptosheets add-on side panel or from the website
See this article for detailed explanation
⚠️ IMPORTANT WARNING
CS.TIME
might well be the single most powerful tool for Excel I've ever seen. It's a genuine game changer and will improve your quality of life by saving you time, stress and mistakes (#AWESOME)Using automatic refresh features can and will significantly increase your quota usage
It is YOUR RESPONSIBILITY to monitor your usage and we will not reset quotas for lower tier accounts that use =CS.TIME() and use up their quota accidentally
You can access your current quota usage in real time ANYtime using the billing section in your your settings (Help Center tutorial: See your subscription usage in real time)
________________________________________________________________
ℹ️ FAQ &TROUBLESHOOTING & RESOURCES
Troubleshooting
Check your syntax for =CS.TIME() carefully, different functions for the same data may have slightly different required syntax
Check the required arguments for =CS.TIME() vs the optional arguments
Check your data & API quotas and limits
Check your formulas carefully
Check your local computer & Excel settings for default date, time, geography, format
Use Excel's error checking tools
Check Excel's help sections: https://support.office.com/en-us/article/function-arguments-65b29fb5-ec7b-4c0b-a54b-a67923571519
Find additional troubleshooting resources and tips here
Other Something else? – Click here for full list of Excel error explanation
Additional Resources
For Microsoft Excel
Web browsers used by add-ins: https://docs.microsoft.com/en-us/office/dev/add-ins/concepts/browsers-used-by-office-web-add-ins
Office versions and requirement sets: https://docs.microsoft.com/en-us/office/dev/add-ins/develop/office-versions-and-requirement-sets
How to check your Office version: https://docs.microsoft.com/en-us/office/dev/add-ins/develop/office-versions-and-requirement-sets#how-to-check-your-office-version
Install the latest version of Office: https://docs.microsoft.com/en-us/office/dev/add-ins/develop/install-latest-office-version
Custom Function Requirements: https://docs.microsoft.com/en-us/office/dev/add-ins/excel/custom-functions-architecture
Cryptosheets is free to sign up and start using now. What are you waiting for?
Signing up for Cryptosheets is free --> Get crypto data in 30 seconds or less
ADDITIONAL RESOURCES
Website | WebApp | Excel | Googlesheets | Help Center | Blog | Twitter
______________________________________________________________
TAGS : refresh, real time, streaming, schedule, upgrade, subscription, exceeded, limit, exhaust, update, live, streaming, invocation, seconds, #BUSY, automatic, googlefinance, schedule, trigger, quota, limit, datetime, time, timestamp, cs.time, cstime, automatic, custom functions, excel, googlesheets, spreadsheet, crypto data, bitcoin, blockchain