---
id: api-account-get-balance
title: GetBalance
---

---

- 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"

    ```shell
    curl -d '{
        "id": "1",
        "jsonrpc": "2.0",
        "method": "GetBalance",
        "params": ["1eefc4f453539e5ee732b49eb4792b268c2f3908"]
    }' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"
    ```

=== "node.js"

    ```js
    const balance = await zilliqa.blockchain.getBalance(
      "1eefc4f453539e5ee732b49eb4792b268c2f3908"
    );
    console.log(balance.result);
    ```

=== "java"

    ```java
    public class App {
        public static void main(String[] args) throws IOException {
            HttpProvider client = new HttpProvider("https://api.zilliqa.com");
            Rep<HttpProvider.BalanceResult> balance = client.getBalance("1eefc4f453539e5ee732b49eb4792b268c2f3908");
            System.out.println(new Gson().toJson(balance));
        }
    }
    ```

=== "python"

    ```python
    from pyzil.zilliqa import chain
    chain.set_active_chain(chain.MainNet)
    print(chain.active_chain.api.GetBalance("1eefc4f453539e5ee732b49eb4792b268c2f3908"))
    ```

=== "go"

    ```go
    func TestGetBalance() {
      provider := NewProvider("https://api.zilliqa.com/")
      response := provider.GetBalance("9bfec715a6bd658fcb62b0f8cc9bfa2ade71434a")
      result, _ := json.Marshal(response)
      fmt.Println(string(result))
    }
    ```

### Example Response

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

### HTTP Request

| Chain(s)              | URL(s)                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **Zilliqa mainnet**   | [https://api.zilliqa.com/](https://api.zilliqa.com/)                                         |
| **Developer testnet** | [https://dev-api.zilliqa.com/](https://dev-api.zilliqa.com/)                                 |
| **Local testnet**     | [http://localhost:4201/](http://localhost:4201/)                                             |
| **Isolated server**   | [https://zilliqa-isolated-server.zilliqa.com/](https://zilliqa-isolated-server.zilliqa.com/) |

### Arguments

| 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. <br/> Example: `"1eefc4f453539e5ee732b49eb4792b268c2f3908"` <br/><br/> Also supports Bech32 address <br/> Example: `"zil1rmhufazn2w09aeejkj0tg7fty6xz7wggup2tsh"` |