namillum
Version:
Bubble Protocol SDK
98 lines (77 loc) • 3.97 kB
Markdown
---
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"` |