Skip to main content

Get Wallet Networks

Returns one node wallet's native-coin balance on every network of the wallet's chain, each valued in US dollars and Turkish lira. Only the wallet id is needed: the owning node is read from the wallet, and that node must be your own node or below it. Find wallet ids with List Node Wallets.

Balances are best-effort: when the custody provider cannot report a network's balance, that network is still listed, with balance_native "0".

Required permission: node:summary:view

Request​

GET /v2/admin/wallets/{wallet_id}/networks

Parameters​

NameTypeInDescription
wallet_idstringpathRequired. A node wallet's id

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/wallets/6a53f3dfad48accdb46eaf9e/networks' \
--header 'Authorization: Bearer <access_token>'

Response​

{
"networks": [
{
"network_id": "6740e0a20000000000000101",
"network_name": "Ethereum",
"native_currency_symbol": "ETH",
"native_currency_logo": "https://s3.tokenizationtr.com/currencies/eth.svg",
"native_currency_decimal": 18,
"balance_native": "0.10861192205980251",
"balance_native_usd": "352.17",
"balance_native_try": "12051.88"
},
{
"network_id": "6740e0a20000000000000102",
"network_name": "Polygon",
"native_currency_symbol": "POL",
"native_currency_logo": "https://s3.tokenizationtr.com/currencies/pol.svg",
"native_currency_decimal": 18,
"balance_native": "0"
}
]
}

Response Fields​

FieldTypeDescription
networksarrayOne row per network of the wallet's chain. Empty when the wallet has no chain or address
networks[].network_idstringNetwork id
networks[].network_namestringNetwork name
networks[].native_currency_symbolstringSymbol of the network's native coin
networks[].native_currency_logostringLogo URL of the native coin
networks[].native_currency_decimalintegerDecimal places of the native coin
networks[].balance_nativestringThe wallet's native-coin balance, as a decimal string
networks[].balance_native_usdstringThat balance in US dollars. Omitted when no price is available
networks[].balance_native_trystringThat balance in Turkish lira. Omitted when no price is available

Amounts are decimal strings; see Amounts and Percentages.

Errors​

StatusCodeDescription
40010016wallet_id is not a valid id
40010001Wallet not found, it is not a node wallet, or its node no longer exists (node domain 2)
40310005The wallet's node is outside your part of the hierarchy (node domain 2)

See Errors for the error format and common codes.