Skip to content

Get Balance

  • Returns the current balance of an account, measured in the smallest accounting unit Qa (or 10^-12 Zil). This is represented as a String.

  • Returns the current nonce of an account. This is represented as a Number.

Example Request

curl -d '{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "GetBalance",
    "params": ["1eefc4f453539e5ee732b49eb4792b268c2f3908"]
}' -H "Content-Type: application/json" -X POST ""
const balance = await zilliqa.blockchain.getBalance(
public class App {
    public static void main(String[] args) throws IOException {
        HttpProvider client = new HttpProvider("");
        Rep<HttpProvider.BalanceResult> balance = client.getBalance("1eefc4f453539e5ee732b49eb4792b268c2f3908");
        System.out.println(new Gson().toJson(balance));
from pyzil.zilliqa import chain
func TestGetBalance() {
  provider := NewProvider("")
  response := provider.GetBalance("9bfec715a6bd658fcb62b0f8cc9bfa2ade71434a")
  result, _ := json.Marshal(response)

Example Response

  "id": "1",
  "jsonrpc": "2.0",
  "result": {
    "balance": "18446744073637511711",
    "nonce": 16

HTTP Request

Chain(s) URL(s)
Zilliqa mainnet
Developer testnet
Local testnet http://localhost:4201/
Isolated server


Parameter Type Required Description
id string Required "1"
jsonrpc string Required "2.0"
method string Required "GetBalance"
params string Required An User's account address of 20 bytes.
Example: "1eefc4f453539e5ee732b49eb4792b268c2f3908"

Also supports Bech32 address
Example: "zil1rmhufazn2w09aeejkj0tg7fty6xz7wggup2tsh"