Get User Wallet Network Assets

Returns a wallet's holdings on one network:

• the network's native coin (symbol, logo, decimals and the wallet's balance, valued in USD and TRY) inline. It has no id, because it is the chain's own coin rather than a deployed contract;
• assets: every active, deployed stable currency token on that network with the wallet's balance, each valued in USD and TRY. A row's id is what Get User Wallet Network Asset takes.

network_id must belong to the wallet's chain (see Get User Wallet Networks). Balances and valuations are best-effort: the native balance reads "0" when custody cannot be read, assets comes back empty when the token balances cannot be read, and the USD / TRY fields are omitted when no spot price is available. Same read and shape as the node surface's GET /v2/admin/wallets/{wallet_id}/networks/{network_id}/assets.

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

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 on the wallet's chain

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

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

Response

{
  "network_id": "6740e0a20000000000000103",
  "network_name": "Ethereum Sepolia",
  "native_currency_symbol": "ETH",
  "native_currency_logo": "https://s3.tokenizationtr.com/currencies/eth.svg",
  "native_currency_decimal": 18,
  "balance_native": "0.8006712018779228",
  "balance_native_usd": "2802.35",
  "balance_native_try": "96120.4",
  "assets": [
    {
      "id": "6900a1fd2a4de1c5748e9dcc",
      "name": "USD Coin",
      "symbol": "USDC",
      "logo": "https://s3.tokenizationtr.com/currencies/usdc.svg",
      "decimal": 6,
      "amount": "988.4805",
      "amount_usd": "988.48",
      "amount_try": "33901.2"
    }
  ]
}

Response Fields

Field	Type	Description
network_id	string	Network ID
network_name	string	Display name of the network
native_currency_symbol	string	Native coin symbol
native_currency_logo	string	Native coin logo URL
native_currency_decimal	integer	Native coin decimals
balance_native	string	The wallet's native-coin balance
balance_native_usd	string	Optional. Native balance valued in USD
balance_native_try	string	Optional. Native balance valued in TRY
assets	array	Currency tokens on this network with the wallet's balance. Never null
assets[].id	string	Currency token ID (the asset_id of the item read, and the currency_token_id of a withdraw)
assets[].name	string	Token name
assets[].symbol	string	Token symbol
assets[].logo	string	Logo URL; empty when none
assets[].decimal	integer	Token decimals
assets[].amount	string	The wallet's balance
assets[].amount_usd	string	Optional. Balance valued in USD
assets[].amount_try	string	Optional. Balance valued in TRY

Errors

Status	Code	Description
400	10016	wallet_id is not a valid id
400	10001	Wallet not found or not this user's (domain 1, message user not found)
400	10001	network_id is not a network of the wallet's chain (domain 2, message node not found)

See Errors for the error format and common codes.