eth_getBalance

Returns the balance of a given address.

Example

Command Shell

## using block numbers 

curl https://bsc-<network>.web3api.com/v1/YOUR-API-KEY 
-X POST 
-H "Content-Type: application/json"  
-d "{\"jsonrpc\":\"2.0\",\"method\":\"eth_getBalance\",\"params\": [\"0x71C7656EC7ab88b098defB751B7401B5f6d8976F\", \"0x6D8185\"],\"id\":1}"

## using pre-defined strings

curl https://bsc-<network>.web3api.com/v1/YOUR-API-KEY 
-X POST 
-H "Content-Type: application/json"  
-d "{\"jsonrpc\":\"2.0\",\"method\":\"eth_getBalance\",\"params\": [\"0x71C7656EC7ab88b098defB751B7401B5f6d8976F\", \"latest\"],\"id\":1}"

Bash

## using block numbers 

curl -X POST 'https://bsc-<network>.web3api.com/v1/YOUR-API-KEY' \
-H 'Content-Type: application/json' \
--data-raw '{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "0x6D8185"],"id":1}'

## using pre-defined strings 

curl -X POST 'https://bsc-<network>.web3api.com/v1/YOUR-API-KEY' \
-H 'Content-Type: application/json' \
--data-raw '{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F", "latest"],"id":1}'

Request Parameters

1. ADDRESS - A string representing the address to check for balance.

2. BLOCK PARAMETER - An int block number in the form of hex, appended with 0x such as 0x6D7FE0, or pre-defined strings latest, earliest, pending.

Web3API's Composer accepts int block numbers, which will be auto-converted to a hex representation before being sent to a node.

Response

Result Fields

BALANCE - A hex code of an integer representing the current address balance in wei.

Body

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