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

# Get Balances

> Returns token balances and USD values for given addresses across multiple chains.



## OpenAPI

````yaml /api-reference/router-api/openapi.yaml post /v2/info/balances
openapi: 3.1.0
info:
  title: Router API
  description: Cross-chain transfer routing API for the Initia ecosystem.
  version: 1.0.0
servers:
  - url: https://router-api.initia.xyz
    description: Mainnet
  - url: https://router-api.initiation-2.initia.xyz
    description: Testnet
security: []
paths:
  /v2/info/balances:
    post:
      tags:
        - Assets & Chains
      summary: Get Balances
      description: >-
        Returns token balances and USD values for given addresses across
        multiple chains.
      operationId: getBalances
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - chains
              properties:
                chains:
                  type: object
                  description: A map of chain IDs to address and denomination queries.
                  additionalProperties:
                    type: object
                    required:
                      - address
                      - denoms
                    properties:
                      address:
                        type: string
                        description: Account address on the chain.
                      denoms:
                        type: array
                        description: List of token denominations to query.
                        items:
                          type: string
            example:
              chains:
                interwoven-1:
                  address: init1abc...
                  denoms:
                    - uinit
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  chains:
                    type: object
                    description: A map of chain IDs to balance results.
                    additionalProperties:
                      type: object
                      properties:
                        denoms:
                          type: object
                          additionalProperties:
                            type: object
                            properties:
                              amount:
                                type: string
                                description: Raw token amount.
                              price_usd:
                                type: string
                                description: Current USD price per token.
                              value_usd:
                                type: string
                                description: Total USD value of the balance.
              example:
                chains:
                  interwoven-1:
                    denoms:
                      uinit:
                        amount: '1000000'
                        price_usd: '1.50'
                        value_usd: '1.50'

````