By ZMOK Blog in Tutorial — May 25, 2023

Utilizing ZMOK's JSON RPC API to Retrieve Ethereum Balance

In the evolving landscape of blockchain technology, accessing your Ethereum balance swiftly and securely is crucial. ZMOK facilitates this process with its powerful JSON RPC API. Let's go over the steps to efficiently utilize this feature.

Connect to ZMOK

To access ZMOK's JSON RPC API, you need to connect your wallet to ZMOK or use username/password sign-up.

Use JSON RPC API with Curl

After connecting your wallet, you can now start to query your Ethereum balance. The method we will use is eth_getBalance.

Here is the API documentation for your reference.

Prepare the Parameters

For the eth_getBalance method, we need two parameters:

DATA: This is your Ethereum address in hex format. For this example, we will use "0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8".
QUANTITY|TAG: This is an integer block number, or the string "latest", etc. In this example, we will use "latest".

Send a Request

Here is a sample request to ZMOK using curl. Remember to replace YOUR_API_KEY with your own ZMOK API key.

curl -i -X POST \ 
-H "Content-Type: application/json" \ 
--data '{"jsonrpc":"2.0","method":"eth_getBalance","params": "0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8","latest"],"id":1}' \ "https://zmok.io/mainnet/YOUR_API_KEY"

or use Websockets:

wscat -c wss://zmok.io/mainnet/YOUR_API_KEY -x 
'{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8","latest"],"id":1}'

Response Example

A successful request will return a response in a similar format to the one below:

{
"jsonrpc":"2.0",
"id":1,
"result":"0x174876E800"
}

The result value 0x174876E800 represents the balance of the Ethereum address in Wei. This is a hex format value, which can be converted to decimal format using a simple command, such as echo $((16#174876E800)).

Converting Wei to Ether

Ethereum's basic unit is Wei. To convert the balance to Ether, divide the result by 1000000000000000000. For instance, if your balance was 0x174876E800 Wei, your Ether balance would be 1 Ether.

Navigating the complex world of blockchain becomes straightforward when you have powerful tools like ZMOK's JSON RPC API at your disposal. The above guide should help you retrieve your Ethereum balance quickly and efficiently. Remember, in blockchain, knowledge is power.