Skip To Content

Blockdaemon Documentation

cURL (Quick Start)

Overview
1. Generate a Ubiquity API Key on Blockdaemon App
2. Authorize and Send a Request with Ubiquity
3. Receive a Response


Overview

This guide allows you to quickly get started with Ubiquity.

Within this guide, we explain how to use Ubiquity with cURL. 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 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. Authorize and Send a Request with Ubiquity

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

1. Launch your preferred command line tool, such as macOS Terminal, Windows Command Prompt, etc. Please note that in some cases you will also need to install cURL.

2. Paste and run your request:

curl -X GET 'https://ubiquity.api.blockdaemon.com/v1/ethereum/mainnet/sync/block_number" -H "Authorization: Bearer YOUR_API_KEY'

Note: You need to authorize your request before sending. Set your API key as a bearer token in the authorization header:

-H  'Authorization: Bearer YOUR_API_KEY'

3. Receive a Response

The API response will be displayed in your command line tool.

The received output contains the current block number for Ethereum Mainnet:

15119682

Learn more about the endpoint: GET Current Block Number (V1)

We don't support Internet Explorer

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