Skip to main content

/accounts/{accountId}/asset-balances REST API Endpoint

Get an array of asset-balances for an account.

Updated on
Sep 02, 2024

Path Parameters

accountId
string
REQUIRED

The SS58 address of the account.

Query Parameters

at
string

The block at which to query asset-balance info for the specified account.

assets
array

An array of AssetId's to be queried. If not supplied, defaults to providing all asset balances associated with the accountId will be returned

Returns

at
object

An object containing information about the state

hash
string

The block's hash

height
string

The block's height

assets
array

An array of objects, each representing an asset held by the account.

assetId
string

The unique identifier of the asset.

balance
string

The balance of the asset held by the account.

isFrozen
boolean

Whether the asset is frozen for non-admin transfers. Note, that some runtimes may not have support for isFrozen and if so the following will be returned `isFrozen does not exist for this runtime

isSufficient
boolean

Whether a non-zero balance of this asset is a deposit of sufficient value to account for the state bloat associated with its balance storage. If set to true, then non-zero balances may be stored without a consumer reference (and thus an ED in the Balances pallet or whatever else is used to control user-account state growth)

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free