Skip To Content

Blockdaemon Documentation

Getting Started with Ubiquity

Overview
1. Generating a Ubiquity API Key
2. Installing Postman
3. Authorizing a Request with Ubiquity
4. Sending a Request with Ubiquity
5. Receiving a Response


Overview

This guide allows you to quickly get started with Ubiquity.

Within this guide, we recommend using Postman as the easiest way to get started. Alternative clients and methods of access are available.


1. Generating a Ubiquity API Key

To use the Ubiquity API, you need to get the API access key. This is a 47-character unique number.

To generate a Ubiquity API key, sign up to the Blockdaemon application and take the following steps:

  1. Navigate to the Ubiquity API section
  2. Click on Start using the Blockdaemon API
  3. In the pop-up window, enter your desired Key Name
  4. Click on the Create API Key button to generate the key
  5. Click on your key to copy it

Existing Blockdaemon API key holders:

  • Navigate to Ubiquity API > Configure
  • Click on Create New Key
  • Take steps 3–5 above

Check out Keke’s video guide on creating your Ubiquity API Key

Please Note

  • If you lose the key, you will not be able to retrieve it
  • You should immediately store your key in a secure place

2. Installing Postman

The easiest way to access Ubiquity is via a GUI API client, for example, Postman (Alternative clients and methods of access are available).

You can sign up to Postman and either:

  • Install the application on your computer
  • Use the web version

3. Authorizing a Request with Ubiquity

You need to authorize your request before sending:

  1. Go to your workspace in Postman
  2. Click on the ‘+’ button on the top to open a new tab
  3. Navigate to the Authorization tab under the URL input field
  4. Select Bearer Token from the Type drop-down menu
  5. Paste your API key into the Token input box

4. Sending a Request with Ubiquity

This example uses Ubiquity to get the current block number in Ethereum Mainnet:

  1. In the URL input field, paste the following address:
    https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/sync/block_number
  2. Select GET from the drop-down menu on the left
  3. Click on the Send button on the right

5. Receiving a Response

The API response is displayed at the bottom part of Postman, in the Body tab.

The received output contains the number of the current block in Ethereum Mainnet:

14589247

To learn more, see the Ubiquity developer documentation.

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.