Get User Wallet Network Asset

Reads one asset the wallet holds on a network: the currency token's metadata plus the amount held in this wallet. It is the item read of Get User Wallet Network Assets: take asset_id from an assets[].id there. The network's native coin has no id and is only readable from that listing.

The asset must be active, deployed and on the named network, and the network must be on the wallet's chain; otherwise the answer is "not found" rather than a zero balance. Unlike the listing, this read is not best-effort: a balance that cannot be read fails the request. Replaces GET /v2/users/{user_id}/wallets/{wallet_id}/currency-tokens/{currency_token_id}.

The wallet must belong to this user. Another user's wallet (or a node's) is reported as not found.

Required permission: user:view

Request

GET /v2/users/{user_id}/wallets/{wallet_id}/networks/{network_id}/assets/{asset_id}

Parameters

Name	Type	In	Description
user_id	string	path	Required. User ID
wallet_id	string	path	Required. Wallet ID
network_id	string	path	Required. Network ID; must be the asset's network and on the wallet's chain
asset_id	string	path	Required. Currency token ID (an assets[].id of the listing)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/wallets/6a8754e187be1d0e22aa6d83/networks/6740e0a20000000000000103/assets/6900a1fd2a4de1c5748e9dcc' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "currency_token": {
    "id": "6900a1fd2a4de1c5748e9dcc",
    "node_id": "665ae536a6392b75cfd40352",
    "type": 1,
    "status": 3,
    "name": "USD Coin",
    "symbol": "USDC",
    "total_supply": "0",
    "description": "Stablecoin pegged to USD",
    "decimals": 6,
    "meta": {
      "logo": {
        "url": "https://s3.tokenizationtr.com/currencies/usdc.svg"
      }
    },
    "contract": {
      "address": "0x6810572a2e15fd1508b485b053417e9397e70f49"
    },
    "is_active": true,
    "created_at": "2025-10-28T10:59:09.752Z",
    "updated_at": "2025-10-28T10:59:09.752Z"
  },
  "amount": "988.4805"
}

Response Fields

Field	Type	Description
currency_token	object	The asset
currency_token.id	string	Currency token ID
currency_token.node_id	string	Node that owns the currency token
currency_token.type	integer	1 Stable, 2 Utility, 3 Native
currency_token.status	integer	1 Draft, 2 InProgress, 3 Active, 4 Error, 5 Passive (always 3 here)
currency_token.name	string	Name
currency_token.symbol	string	Symbol
currency_token.total_supply	string	Total supply
currency_token.description	string	Description
currency_token.decimals	integer	Decimals
currency_token.meta.logo	object | null	Logo; url is the image URL
currency_token.contract.address	string	Contract address
currency_token.is_active	boolean	Active flag
currency_token.created_at	string	ISO 8601 creation time
currency_token.updated_at	string	ISO 8601 time of the last change
amount	string	The wallet's balance of this asset

Errors

Status	Code	Description
400	10016	wallet_id is not a valid id
400	10000	asset_id is not a valid id
400	10001	Wallet not found or not this user's (domain 1, message user not found)
404	10001	Domain 15: asset not found, asset is not on this network, or network does not belong to this wallet's chain
400	10005	Asset is not active (domain 15)
400	10004	Asset contract not deployed (domain 15)
400	10015	network not found / currency token has no network

See Errors for the error format and common codes.