Task: Account Balance
If you have enabled a coin with task managed activation and are using HD Mode, your funds may be spread across a range of addresses under a specified account index. The methods below will return the combined balance of your account, detailing the balance for each active account address.
API-v2task::account_balance::init
Use the task::account_balance::init method to initialise an account balance request.
| Parameter | Type | Description |
|---|---|---|
| coin | string | Ticker of activated coin you want to see addresses and balance for |
| account_index | string | For GUIs, this will be zero. In CLI you can use other values if you know what you are doing |
| Parameter | Type | Description |
|---|---|---|
| task_id | integer | An identifying number which is used to query task status. |
task::account_balance::init
POST
task::account_balance::init{
"userpass": "RPC_UserP@SSW0RD",
"mmrpc": "2.0",
"method": "task::account_balance::init",
"params": {
"coin": "COIN_NAME",
"account_index": 0
}
}
API-v2task::account_balance::status
Use the task::account_balance::status method to view the status / response of an account balance request.
| Parameter | Type | Description |
|---|---|---|
| task_id | integer | The identifying number returned when initiating the task. |
| forget_if_finished | boolean | If false, will return final response for completed tasks. Optional, defaults to true. |
| Parameter | Type | Description |
|---|---|---|
| current_block | integer | Block height of the coin being activated |
| ticker | string | Ticker of the coin being activated. |
| wallet_balance | object | A standard WalletBalanceInfo object. Note: the structure may vary based on the get_balances parameter value in the activation request. |
task::account_balance::status
POST
task::account_balance::status{
"userpass": "RPC_UserP@SSW0RD",
"mmrpc": "2.0",
"method": "task::account_balance::status",
"params": {
"task_id": 3,
"forget_if_finished": false
}
}
API-v2task::account_balance::cancel
Use the task::account_balance::cancel method to cancel an account balance request.
| Parameter | Type | Description |
|---|---|---|
| task_id | integer | The identifying number returned when initiating the task. |
| Parameter | Type | Description |
|---|---|---|
| result | string | Returns with value success when successful, otherwise returns the error values below |
| error | string | Description of the error |
| error_path | string | Used for debugging. A reference to the function in code base which returned the error |
| error_trace | string | Used for debugging. A trace of lines of code which led to the returned error |
| error_type | string | An enumerated error identifier to indicate the category of error |
| error_data | string | Additonal context for the error type |
task::account_balance::cancel
POST
task::account_balance::cancel{
"userpass": "RPC_UserP@SSW0RD",
"mmrpc": "2.0",
"method": "task::account_balance::cancel",
"params": {
"task_id": 3,
"forget_if_finished": false
}
}