Skip To Content

Blockdaemon Documentation

Postman (Quick Start)

Overview
1. Generate a Ubiquity API Key on Blockdaemon App
2. Install Postman
3. Authorize a Request with Ubiquity
4. Send a Request with Ubiquity
5. Receive a Response


Overview

This guide allows you to quickly get started with Ubiquity.

Within this guide, we explain how to use Ubiquity with Postman. Alternative clients and methods of access are available: see quick start guides for other tools.


1. Generate a Ubiquity API Key on Blockdaemon App

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 Ubiquity API > Connect > API Keys
  2. Click on Create API Key
  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

Check out our 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. Install 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. Authorize 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. Send 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://svc.blockdaemon.com/universal/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. Receive 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:

15119682

Learn more about the endpoint: GET Current Block Number

We don't support Internet Explorer

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