getwalletbalance Method
Returns the balance of the corresponding asset in the wallet, based on the specified asset number. This method applies to the contract assets that conform to NEP-17 standards.
Before you can invoke this method you must:
Install the plugin RpcServer
Call the RPC method
openwallet
to open the wallet first.
Parameter Description
Asset_id: Asset ID (asset identifier), which is the script hash of the contract for contract assets.
For example, NEO is 0xef4073a0f2b305a38ec4050e4d3d28bc40ea63f5
Gas is 0xd2a4cff31913016155e38e474a2c06d08be276cf
You can query asset ID using the CLI command list asset
or using the blockchain browser.
Exception
-
-302, No opened wallet.
Example
Make sure your client has been fully synchronized to the latest block height before using this API, otherwise the balance returned may not be up-to-date.
Example: querying the balance of NEP-17 assets.
Request body:
Response body:
Response Description:
balance: the balance of the asset in the wallet. Since the NEP-17 assets adopt the balance system rather than the UTXO system, there is no confirmed
in the returned result and the balance is the actual available balance.
Only when your client synchronizes to the block that the contract was deployed, execution of this API will return the correct value, otherwise execution of the API will result in an error.
When the input parameter is a script hash of a non-NEP-17 smart contract, execution of the API will result in an error.