In this guide, we will walk you through the steps to perform a query on a REST endpoint to retrieve onchain data.

​
Prerequisites

Before you begin, ensure you have the following:
  • An API key
  • A REST client (e.g., Postman, curl)

​
Steps to Perform a Query

  1. Identify the endpoint URL: The base URL for the API is https://api.data.ormilabs.com/.
  2. Add the endpoint path: Append the specific endpoint path to the base URL, e.g., /v2/{chain_name}/blocks/{block_number}.
  3. Include query parameters: Add any necessary query parameters to the URL, e.g., ?param1=value1&param2=value2.
  4. Set up headers: Include the required headers, such as Authorization with your API key.
  5. Make the request: Use your REST client to send a GET request to the constructed URL.
You may find all our API definitions in the API Reference or access them below: 0xapi-logo

Access Now

Access Data APIs Now for Free

​
Example - Performing a Query to Fetch ERC20 Transfers

Here is an example of a query to retrieve the token balance of a wallet address on the Ethereum mainnet:
  1. Identify the endpoint URL by navigating to the API Reference.
Retrieve ERC20 transfers
  1. Copy and paste the required endpoint path and query parameters into the editor, then click “Send” to make the request.
Perform Query
  1. You may use any third-party tool such as curl or Postman to directly query the endpoint.
Using Curl
  1. The API Reference page also provides handy code snippets for various programming languages to help you get started.
Using Other Programming Languages