Integrating Google Sheets

BDLTSCAN 's APIs provides a convenient way to connect and import block explorer information for developers to use in your own apps and services 💻 .

Having technical knowledge is not a requirement for using APIs however, and non-developers 🙌 can make use of the available endpoints to build your own dashboards and statistics by importing API data to Google Sheets

A valid BDLTSCAN API key and a Google Account is required to follow along this tutorial.

1. Integrating Google Apps Script

In a new Google Sheets document, head over to Extensions > Apps Script.

We'll be utilizing an open source script called ImportJSON developed by @bradjasper and @tommyvernieri to help parse JSON responses returned by the API endpoints

Paste the source code into the script editor, optionally you can rename the file to ImportJSON.gs.

2. Setting up auto refresh

Add a new Sheet from the small "+" icon at the bottom left and name it AutoRefresh.

Back to Google Apps Script, create a new file and name it AutoRefresh.gs. Paste in this following code.

The idea of this script is to generate a random number to the AutoRefresh sheet, which is then appended to the end of the ImportJSON request. Google Sheets only performs a new request if it detects that a formula has changed.

With the script in place, we can run this function every minute by going to Triggers > Add Trigger at the left panel.

Select the function as AutoRefresh, event source as Time Driven, time based trigger to Minutes Timer and minute interval to Every Minute.

3. Making an API request

Once you have added both scripts, go back to Sheet1 and start making API endpoint calls with the following syntax in cell A1.

Parameterr Description
url the endpoint url to make requests from, with your API Key
query comma separated paths to import, such as /result or /result/SafeGasPrice
parseOptions list of options to process the returned data, either noInherit, noTruncate, rawHeaders, noHeaders or allHeaders

The query above will return the following response, and refreshes auto-magically every minute!

Extending and Building a Dashboard

While the above was a straightforward method to call an API endpoint and output the response into a Google Sheet, it could use further optimizing and data formatting.

Checkout some prepared dashboard examples we have, simply duplicate this by going to File > Make a copy and go about customizing this to your taste!