Skip to main content

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

Get an array of asset-balances for an account.

Updated on
Sep 2, 2024

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

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
1
curl --location 'https://docs-demo.dot-mainnet.quiknode.pro/accounts/{accountId}/asset-balances' \
2
--header 'Accept: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free