Get Account Web Wallet Token Info

1. Overview & Typical Use

Query the token list held and followed by a specified account in the web wallet, including balances, valuations, and token metadata.

• Typical use: wallet asset overview, token holdings display, portfolio valuation calculation.
• When not to use: for transfer details of a specific token use the corresponding transfer list endpoint; for resource info use “Get Unfreezable TRX Amount for an Address”.

2. Endpoint & Authentication

GET /api/account/wallet

For Base URL and authentication, see Common Network & Authentication. This endpoint requires an API Key: calls without a Key return 401.

3. Request

# Query wallet token info for a specific address
curl -s 'https://apilist.tronscanapi.com/api/account/wallet?address=TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb' \
  -H 'TRON-PRO-API-KEY: <your-key>'

4. Response

{
  "code": 200,
  "status": "1",
  "message": "request ok",
  "lastUpdateSeconds": 1714514400000,
  "count": 3,
  "data": [
    {
      "token_id": "_",
      "token_abbr": "trx",
      "token_name": "trx",
      "token_type": 0,
      "token_decimal": 6,
      "balance": "0.000000",
      "token_value": "0.000000",
      "token_value_in_usd": "0",
      "token_price_in_usd": "0.06561",
      "token_price": "1",
      "level": 2,
      "frozen": 0,
      "frozenV2": 0,
      "frozen_token_value_in_usd": 0,
      "frozenV2_token_value_in_usd": 0,
      "pair_id": 48,
      "vip": false,
      "token_url": "https://static.tronscan.org/production/logo/trx.png"
    }
  ],
  "totalValueInUsd": 0.0
}

5. Errors

For HTTP status codes, see Common Errors. Notes for this endpoint:

• API Key Required: returns 401 if not provided (see Common Network & Authentication).
• Missing required parameter: address is required; omitting it returns 400 ({"message":"some parameters are invalid or out of range"}), not 401.
• Empty result is not an error: no token holdings returns 200 + data: [], which is a normal response.