Beginner's Guide: Getting Ethereum Balance using Web3j and Java


In this beginner's tutorial, we will guide you through the process of retrieving the Ethereum balance of a specific address using Web3j and Java. We will assume that you have a basic understanding of Java programming and are familiar with setting up a Java project.

The tutorial will cover the following steps:

  1. Setting up an Ethereum endpoint using We will use, a popular service that allows us to connect to the Ethereum network without running a full Ethereum node.
  2. Setting up Web3j SDK: We will include the Web3j library in our Java project and import the necessary classes for Ethereum interaction.
  3. Getting balance: We will create a Web3j instance, connect it to the Ethereum network, and retrieve the balance of a specified Ethereum address.
  4. Scaling, etc.: We will explore options for converting the balance from Wei to different denominations and handling large numbers.

By the end of this tutorial, you will have the knowledge to fetch Ethereum balances using Web3j and integrate this functionality into your Java applications. So, let's get started and dive into the world of Ethereum development with Java and Web3j!

What is is a widely-used infrastructure provider for accessing the Ethereum blockchain. It serves as a gateway that allows developers to interact with the Ethereum network without the need to run their own Ethereum node. provides a reliable and scalable infrastructure, handling the complexities of running and maintaining Ethereum nodes, and offering a simplified way to connect to the Ethereum network.

Key features and benefits of using include:

  1. Ethereum Node Access: provides access to both the Ethereum Mainnet and various test networks (Ropsten, Rinkeby, Kovan). Developers can connect to Infura's Ethereum nodes through API endpoints.
  2. Simplified Integration: Instead of setting up and managing their own Ethereum node infrastructure, developers can utilize's infrastructure, which greatly simplifies the integration process and reduces the operational overhead.
  3. Scalability and Reliability: handles the infrastructure requirements of running Ethereum nodes, ensuring scalability and reliability. This allows developers to focus on building their applications without worrying about maintaining and scaling their own nodes.
  4. Broad Developer Adoption: is widely adopted in the Ethereum ecosystem and has become a de facto standard for connecting to the Ethereum network. Many popular blockchain projects, decentralized applications, and wallets rely on for their Ethereum connectivity.
  5. Developer-Friendly APIs: provides a user-friendly API that abstracts the complexities of interacting with Ethereum nodes directly. It offers a range of APIs for various Ethereum functionalities, including retrieving account balances, sending transactions, querying smart contracts, and listening for events.
  6. WebSocket Support: In addition to HTTP-based APIs, also supports WebSocket connections. WebSocket provides real-time data streaming capabilities, enabling developers to receive instant updates and notifications from the Ethereum network.

Setting up an Ethereum endpoint using

  1. Sign up for an account on, which provides a gateway to interact with the Ethereum network.
  2. Create a new project and obtain the project ID and endpoint URL.

What is Web3j?

Web3j is a popular Java library that allows developers to interact with the Ethereum blockchain and build decentralized applications (DApps) using the Java programming language. It provides a set of tools, APIs, and utilities that simplify the process of integrating Java applications with the Ethereum network.

Web3j serves as a client library for Ethereum, enabling developers to connect to Ethereum nodes, send transactions, deploy smart contracts, and retrieve data from the blockchain. It abstracts the complexity of working directly with Ethereum's JSON-RPC API and provides a more user-friendly and developer-friendly interface.

Key features of Web3j include:

  1. Ethereum Integration: Web3j supports seamless integration with the Ethereum network, allowing developers to interact with accounts, contracts, and blockchain data.
  2. Smart Contract Deployment and Interaction: With Web3j, developers can compile and deploy smart contracts written in Solidity, Ethereum's native programming language. They can also create Java wrappers for smart contracts, making it easier to interact with them from Java code.
  3. Transaction Management: Web3j simplifies the process of sending and managing transactions on the Ethereum network. It provides methods for building and signing transactions, estimating gas costs, and handling transaction receipts.
  4. Event Listening: Web3j allows developers to listen for events emitted by smart contracts. This feature enables real-time notification and integration with external systems based on specific events occurring on the Ethereum blockchain.
  5. Integration with Web3 Infrastructures: Web3j integrates seamlessly with popular Ethereum infrastructures like, which provides access to the Ethereum network without running a local node.
  6. Support for Ethereum Standards: Web3j supports various Ethereum standards such as ERC-20 (token standard), ERC-721 (non-fungible token standard), and ERC-1155 (multi-token standard), making it easier to interact with tokens and decentralized finance (DeFi) protocols.

Setting up Web3j SDK

  • Include the Web3j library in your Java project. You can either download the JAR file and add it to your project's classpath or use a build automation tool like Maven or Gradle to manage dependencies.
  • Import the necessary Web3j classes into your Java class:
import org.web3j.protocol.Web3j;
import org.web3j.protocol.core.DefaultBlockParameterName;
import org.web3j.protocol.http.HttpService;
import org.web3j.protocol.core.methods.response.EthGetBalance;
import org.web3j.utils.Convert;

Getting balance

Create an instance of the Web3j object and connect it to the Ethereum network using the endpoint URL obtained from

Web3j web3 = HttpService(""));

Specify the Ethereum address for which you want to retrieve the balance:

String address = "0xYourEthereumAddress";

Use the web3.ethGetBalance method to fetch the balance of the specified address:

EthGetBalance balanceResponse = web3.ethGetBalance(address, DefaultBlockParameterName.LATEST).send();

Check if the response was successful and retrieve the balance value in Wei:

if (balanceResponse.hasError()) {
    System.out.println("Error occurred: " + balanceResponse.getError().getMessage());
} else {
    BigInteger balanceWei = balanceResponse.getBalance();
    System.out.println("Balance in Wei: " + balanceWei);

If you want to convert the balance from Wei to Ether, you can use the Convert.fromWei method:

String balanceEther = Convert.fromWei(balanceWei.toString(), Convert.Unit.ETHER).toPlainString();
System.out.println("Balance in Ether: " + balanceEther);

What is Wei?

Wei is the smallest and fundamental unit of ether (ETH), the native cryptocurrency of the Ethereum blockchain. It is named after Wei Dai, a computer scientist known for his contributions to cryptography and his involvement in the cypherpunk movement.

In the Ethereum ecosystem, wei represents the base unit of value and is used to measure and represent cryptocurrency amounts. It is similar to how Satoshi is the smallest unit of Bitcoin. Wei is an integer value and is represented as a whole number.

The conversion between wei and other denominations of ether is based on a decimal system, where each higher unit is a multiple of 1,000 (or 10^3). Here are some commonly used denominations of ether:

  • 1 Ether (ETH) = 1,000,000,000,000,000,000 Wei (10^18 Wei)
  • 1 Gwei=1,000,000,000 Wei (10^9 Wei)
  • 1 Mwei (or Szabo) = 1,000,000 Wei (10^6 Wei)
  • 1 Kwei (or Ada) = 1,000 Wei (10^3 Wei)

When working with Ethereum balances or transactions, the value is often represented in wei. However, for convenience and readability, developers and users often convert wei values to higher denominations like ether, Gwei, or Szabo.


  • The balance obtained is in Wei, the smallest unit of Ether. You can convert it to different denominations such as Ether, Gwei, or Szabo as per your requirement.
  • To work with large numbers, consider using the BigInteger class provided by Java's java.math package.
  • Make sure to handle exceptions appropriately when working with Web3j methods by using try-catch blocks.

You have now successfully retrieved the Ethereum balance using Web3j and Java. You can customize and extend this code to build more advanced Ethereum applications. 

Want to find a web3 job?

Receive emails of Beginner's Guide: Getting Ethereum Balance using Web3j and Java

More by Manthan Dave
Ask me anything