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

# Get single account balances

> Fetch all vault positions for a specific account from the indexer.
Returns balance information including vault details and current price per share.
If chain_id is not specified, returns balances for all chains.
If include_test_vaults is not specified, defaults to false (excludes test vaults).



## OpenAPI

````yaml /api-reference/openapi-integrator.json get /v1/query/get-account-balances
openapi: 3.0.3
info:
  title: Byzantine Integrator API
  description: Byzantine REST API for integrators.
  license:
    name: ''
  version: 0.2.0
servers:
  - url: https://sandbox.api.byzantine.fi
    description: Sandbox
security: []
tags:
  - name: API health
    description: Check API status.
  - name: Customer management
    description: Endpoints to create, update, and retrieve customer information.
  - name: Account management
    description: Endpoints to manage accounts, bank accounts, invitations, and user roles.
  - name: Products
    description: Endpoints to get data about products and vaults.
  - name: Transactions
    description: Endpoints to create and manage transactions.
  - name: OTP authentication
    description: Endpoints to initialize and manage user authentication with OTP.
  - name: Webhooks
    description: Integrator-managed outbound webhook subscriptions and delivery history.
paths:
  /v1/query/get-account-balances:
    get:
      tags:
        - Account management
      summary: Get single account balances
      description: >-
        Fetch all vault positions for a specific account from the indexer.

        Returns balance information including vault details and current price
        per share.

        If chain_id is not specified, returns balances for all chains.

        If include_test_vaults is not specified, defaults to false (excludes
        test vaults).
      operationId: get_account_balances
      parameters:
        - name: X-Pubkey
          in: header
          description: >-
            Integrator's ECDSA public key (P-256 curve, compressed SEC1 format).
            Example:
            0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd
          required: true
          schema:
            type: string
        - name: X-Timestamp
          in: header
          description: >-
            Unix timestamp in seconds (UTC). Must be within tolerance window (1
            minute) to prevent replay attacks. Example: 1760375826
          required: true
          schema:
            type: string
        - name: X-Signature
          in: header
          description: >-
            ECDSA signature (DER-encoded, hex with 0x prefix). Signs the
            message: {timestamp}{METHOD}{path_and_query}{json_body}. Example:
            0x3045022100...
          required: true
          schema:
            type: string
        - name: account_id
          in: query
          description: The account ID
          required: true
          schema:
            $ref: '#/components/schemas/Uuid'
        - name: chain_id
          in: query
          description: The chain ID to get balances for (optional, default = all chains)
          required: false
          schema:
            type: integer
            format: int32
            nullable: true
        - name: include_test_vaults
          in: query
          description: Whether to include test vaults (optional, default = false)
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: Account balances retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountBalancesResponse'
        '400':
          description: Bad request - Invalid account ID
        '404':
          description: Account not found
        '500':
          description: Internal server error
      security:
        - integrator_auth: []
components:
  schemas:
    Uuid:
      type: string
      format: uuid
      description: A UUID string
      example: 550e8400-e29b-41d4-a716-446655440000
    GetAccountBalancesResponse:
      type: object
      required:
        - account_id
        - sub_accounts
      properties:
        account_id:
          $ref: '#/components/schemas/Uuid'
        sub_accounts:
          type: array
          items:
            $ref: '#/components/schemas/SubAccountBalances'
          description: Array of account's sub-accounts and their balances
    SubAccountBalances:
      type: object
      required:
        - wallet_address
        - positions
        - idle
      properties:
        wallet_address:
          type: string
          description: The sub-account's wallet address
          example: '0xa5b709B14859EdF820347D78E587b1634B0ec791'
        positions:
          type: array
          items:
            $ref: '#/components/schemas/VaultBalance'
          description: List of sub-account's active positions (balances across vaults)
        idle:
          type: array
          items:
            $ref: '#/components/schemas/IdleBalance'
          description: List of sub-account's idle balances
    VaultBalance:
      type: object
      required:
        - chain_id
        - vault_address
        - is_async_vault
        - asset_address
        - currency
        - balance
        - shares
        - price_per_share
      properties:
        chain_id:
          type: integer
          format: int64
          description: The vault's chain ID
        vault_address:
          type: string
          description: The vault's address
        is_async_vault:
          type: boolean
          description: Whether the vault is an asynchronous vault
        asset_address:
          type: string
          description: The asset's contract address
        currency:
          $ref: '#/components/schemas/FiatCurrency'
        balance:
          $ref: '#/components/schemas/Decimal'
        shares:
          $ref: '#/components/schemas/Decimal'
        price_per_share:
          $ref: '#/components/schemas/Decimal'
    IdleBalance:
      type: object
      required:
        - chain_id
        - balance
        - currency
      properties:
        chain_id:
          type: integer
          format: int64
          description: Chain ID where the idle balance is held
        balance:
          $ref: '#/components/schemas/Decimal'
        currency:
          $ref: '#/components/schemas/FiatCurrency'
    FiatCurrency:
      type: string
      enum:
        - usd
        - eur
    Decimal:
      type: string
      description: A high-precision decimal number represented as a string
      example: '123.456789'
  securitySchemes:
    integrator_auth:
      type: apiKey
      in: header
      name: X-Pubkey, X-Timestamp, X-Signature

````