Get Wallet Assets

GET /wallets/{walletId}/assets

Retrieves a list of assets owned by the specified wallet. Return values vary by chain as shown below.

circle-info

Required Permissions

Name
Conditions

Wallets:Read

Always Required

Parameters

Path parameters

Path parameter
Description

walletId

Unique identifier of the wallet.

Query parameters

Query parameter
Description
Type - Optional

netWorth

Set to string value true to quote the wallet's total asset value in USD.

String (optional)

Response Body

Field
Description
Type - Optional

walletId

ID of the wallet.

String

network

Network used for the wallet.

String

assets

A list of asset balances the wallet holds. Fields will vary depending on asset kind, see below.

Array<Asset>

netWorth

Total net worth of the wallet converted to USD. The value will only include Coingecko listed assets.

Record<"USD", Decimal>

Native Asset Fields

Field
Description
Type - Optional

kind

Asset kind is always Native.

String

symbol

Asset symbol.

String

decimals

The smallest unit the token can be divided.

Integer

balance

The balance in the smallest token unit.

String

verified

All native assets are verified. For fungible tokens, whethher the token identities have been verified using the information provided by the token projects.

Boolean (optional)

quotes

For Coingecko listed assets, the value of holding converted to USD.

Record<"USD", Decimal> (optional)

ERC-20 Asset Fields

Field
Description
Type - Optional

kind

Erc20, the Ethereum fungible token standardarrow-up-right.

String

contract

The ERC-20 smart contract address of the fungible token.

String

Algorand Asset Fields

Field
Description
Type - Optional

assetId

The asset ID.

String

Aptos Asset Fields

Field
Description
Type - Optional

kind

Aip21, the Aptos fungible asset standardarrow-up-right.

String

metadata

The asset's metadata address.

String

Iota LockedCoin Asset Fields

Field
Description
Type - Optional

kind

LockedCoin for timelocked coin assetsarrow-up-right.

String

coin

The coin object type of the timelocked coin.

String

Solana Asset Fields

Field
Description
Type - Optional

kind

Asset kind is either Spl for Solana Program Library tokensarrow-up-right, or Spl2022 for the newly upgraded token programarrow-up-right.

String

mint

The token program's mint address.

String

Stellar Asset Fields

Field
Description
Type - Optional

issuer

The asset issuer address.

String

assetCode

The asset code.

String

TON Jetton Asset Fields

Field
Description
Type - Optional

master

The Jetton master smart contract address.

String

TRON TRC-10 Asset Fields

Field
Description
Type - Optional

kind

Trc10, nativearrow-up-right TRON fungible tokens.

String

tokenId

The TRC-10 token ID.

String

TRON TRC-20 Asset Fields

Field
Description
Type - Optional

kind

Trc20, smart contract basedarrow-up-right fungible tokens.

String

contract

The TRC-20 smart contract address.

String

Last updated