> ## Documentation Index
> Fetch the complete documentation index at: https://docs.walletsuite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get balances for native + selected token assets

> 
Returns native + token balances in parallel, skips zero balances, and includes total fiat value.
If assetIds is omitted, uses the default supported set:
- EVM (ethereum): USDT + USDC
- TRON: USDT




## OpenAPI

````yaml /openapi.json get /api/balances/{address}
openapi: 3.1.0
info:
  title: WalletSuite REST API
  description: >-
    Multi-chain wallet operations, balances, prices, and transaction lifecycle
    as a REST API.
  contact:
    name: WalletSuite
    url: https://walletsuite.io
  version: prod
servers:
  - url: https://api.walletsuite.io
    description: WalletSuite API
security:
  - ApiKeyAuth: []
tags:
  - name: Transactions
    description: >-
      Get transaction history by address, check live transaction status, and
      send signed transactions.
  - name: Fees
    description: Fee estimation endpoints
  - name: Balances
    description: Fetch balances on any supported chain (Ethereum, Tron).
  - name: Assets
    description: >-
      List supported blockchain assets from the database loaded at startup from
      bundled resources
  - name: Asset Status
    description: Asset enablement and restrictions.
  - name: Prices
    description: Fiat prices for symbols and contract addresses
  - name: Swaps
    description: Swap quote, route, and transaction building.
  - name: Approvals
    description: Allowance, approval tx data, and approval status.
  - name: NFTs
    description: NFT collections, tokens, owners, and transfer building.
  - name: Staking
    description: Native staking APR, validators, positions, and transaction building.
  - name: Name Service
    description: Name resolution and reverse resolution.
  - name: Chains
    description: Chain registry and chain capabilities.
  - name: Chain Specific
    description: Chain specific endpoints consumable by SDK.
  - name: Blocks
    description: View most recently indexed block information.
  - name: Info
    description: General information and summary counts.
paths:
  /api/balances/{address}:
    get:
      tags:
        - Balances
      summary: Get balances for native + selected token assets
      description: >

        Returns native + token balances in parallel, skips zero balances, and
        includes total fiat value.

        If assetIds is omitted, uses the default supported set:

        - EVM (ethereum): USDT + USDC

        - TRON: USDT
      operationId: assetBalances
      parameters:
        - name: chain
          in: query
          description: Blockchain identifier
          required: false
          schema:
            type: string
            default: ethereum
          example: ethereum
        - name: address
          in: path
          description: Address on the specified chain
          required: true
          schema:
            type: string
          example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
        - name: fiat
          in: query
          description: Fiat currency for valuation
          required: false
          schema:
            type: string
            default: USD
          example: USD
        - name: assetIds
          in: query
          description: >-
            Optional list of token contract ids to include. If empty, defaults
            are used.
          required: false
          schema:
            type: array
            items:
              type: string
          example: >-
            0xdAC17F958D2ee523a2206206994597C13D831ec7,0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
        - name: includeNative
          in: query
          description: Include native balance in response
          required: false
          schema:
            type: boolean
            default: true
          example: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ApiResponseAssetBalancesDto'
components:
  schemas:
    ApiResponseAssetBalancesDto:
      type: object
      properties:
        ok:
          type: boolean
        code:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/AssetBalancesDto'
      required:
        - code
        - message
        - ok
    AssetBalancesDto:
      type: object
      properties:
        chain:
          type: string
        address:
          type: string
        fiatCurrency:
          type: string
        totalFiatValue:
          type: number
        assets:
          type: array
          items:
            $ref: '#/components/schemas/AssetBalanceDto'
      required:
        - address
        - assets
        - chain
        - fiatCurrency
        - totalFiatValue
    AssetBalanceDto:
      type: object
      properties:
        symbol:
          type: string
        decimals:
          type: integer
          format: int32
        tokenContract:
          type: string
        smallestUnit:
          type: integer
        amount:
          type: number
        fiatCurrency:
          type: string
        fiatValue:
          type: number
      required:
        - amount
        - decimals
        - fiatCurrency
        - smallestUnit
        - symbol
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: API key provided by WalletSuite team
      name: x-api-key
      in: header

````