Utila Balances API

openapi: 3.2.0
info:
  title: Utila Address Book Balances API
  version: v2
servers:
- url: https://api.utila.io
security:
- bearerAuth: []
tags:
- name: Balances
paths:
  /v2/vaults/{vault_id}:queryBalances:
    post:
      summary: QueryBalances
      description: Retrieve a list of all asset balances in all wallets in a vault.
      operationId: Balances_QueryBalances
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2QueryBalancesResponse'
      parameters:
      - name: vault_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BalancesQueryBalancesBody'
        required: true
      tags:
      - Balances
  /v2/vaults/{vault_id}/wallets/{wallet_id}:queryBalances:
    post:
      summary: QueryWalletBalances
      description: 'Retrieve a list of all asset balances in a wallet. Can be used also to retrieve assets across all wallets as per

        [AIP-159](https://google.aip.dev/159) by using ''-'' (the hyphen or dash character) as a wildcard character instead of wallet ID in the parent.'
      operationId: Balances_QueryWalletBalances
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2QueryWalletBalancesResponse'
      parameters:
      - name: vault_id
        in: path
        required: true
        schema:
          type: string
      - name: wallet_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BalancesQueryWalletBalancesBody'
        required: true
      tags:
      - Balances
  /v2/vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}:queryBalances:
    post:
      summary: QueryWalletAddressBalances
      description: 'Retrieve a list of all asset balances in a wallet address. Can be used also to retrieve assets across all wallet adresses of a wallet as per

        [AIP-159](https://google.aip.dev/159) by using ''-'' (the hyphen or dash character) as a wildcard character instead of wallet address ID in the parent.'
      operationId: Balances_QueryWalletAddressBalances
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2QueryWalletAddressBalancesResponse'
      parameters:
      - name: vault_id
        in: path
        required: true
        schema:
          type: string
      - name: wallet_id
        in: path
        required: true
        schema:
          type: string
      - name: address_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BalancesQueryWalletAddressBalancesBody'
        required: true
      tags:
      - Balances
  /v2/vaults/{vault_id}:refreshAssetAddressBalance:
    post:
      summary: RefreshAssetAddressBalance
      description: Refreshes address balance for given address.
      operationId: Balances_RefreshAssetAddressBalance
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2RefreshAssetAddressBalanceResponse'
      parameters:
      - name: vault_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BalancesRefreshAssetAddressBalanceBody'
        required: true
      tags:
      - Balances
  /v2/vaults/{vault_id}/wallets/{wallet_id}:queryUTXOs:
    post:
      summary: QueryWalletUTXOs
      description: Retrieve a list of all UTXOs in a wallet.
      operationId: Balances_QueryWalletUTXOs
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v2QueryWalletUTXOsResponse'
      parameters:
      - name: vault_id
        in: path
        required: true
        schema:
          type: string
      - name: wallet_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BalancesQueryWalletUTXOsBody'
        required: true
      tags:
      - Balances
components:
  schemas:
    v2TransactionTronTransactionUnfreezeBalanceV2:
      type: object
      properties:
        ownerAddress:
          description: 'The source of the transaction.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        amount:
          type: string
          example: '1500000'
          description: 'Amount of TRX to be unstaked, in SUN.


            Example: `1500000`.'
        resource:
          description: 'The resource to unfreeze.


            Can be one of the following:

            1. `BANDWIDTH`

            2. `ENERGY`'
          allOf:
          - $ref: '#/components/schemas/v2TransactionTronTransactionTronResourceEnum'
        asset:
          type: string
          example: assets/native.tron-mainnet
          description: 'The asset that is being unstaked.


            Example: `assets/native.tron-mainnet`.'
    apiUserRoleEnum:
      type: string
      enum:
      - ADMIN
      - SIGNER
      - VIEWER
      - OWNER
      - NON_SIGNING_OPERATOR
      - NON_SIGNING_ADMIN
    TransactionTonTransactionMessage:
      type: object
      properties:
        address:
          type: string
          description: The destination of the call.
        amount:
          type: string
          description: Native Nanoton amount to send.
        payload:
          type: string
          title: 'The payload of the message.

            If not provided - This means this message is a contract deployment or a native transfer'
        stateInit:
          type: string
          description: The initial state of the message.
      required:
      - address
      - amount
    v2UTXOState:
      type: string
      enum:
      - AVAILABLE
      - LOCKED
      - FROZEN
      description: " - AVAILABLE: The UTXO is available for spending.\n - LOCKED: The UTXO is locked by a pending transaction.\n - FROZEN: The UTXO is frozen due to compliance reasons and cannot be spent."
    TransactionTransferPrivateToPublic:
      type: object
      properties:
        sender:
          $ref: '#/components/schemas/apiv2Address'
        recipient:
          $ref: '#/components/schemas/apiv2Address'
        sentAmount:
          type: string
          description: Amount credited to the recipient's public account.
        changeAmount:
          type: string
          description: Remainder returned to the sender as a record.
    v2Wallet:
      type: object
      properties:
        name:
          type: string
          example: vaults/1b25635a5b3f/wallets/95257c5a522f
          description: 'The resource name of the wallet.


            Format: `vaults/{vault_id}/wallets/{wallet_id}`'
          readOnly: true
        displayName:
          type: string
          example: DeFi wallet
          description: 'A human-readable name.


            Must match the regular expression `[a-zA-Z0-9\.,:\-''# _$]+$` and be shorter than 100 characters'
        external:
          type: boolean
          description: 'Whether this wallet is external.


            External wallets are wallets that are not managed by Utila.'
          readOnly: true
        archived:
          type: boolean
          description: Whether this wallet is archived.
          readOnly: true
        convertedValue:
          description: 'The converted value of all assets in this Wallet.

            Included only when `FULL` view is requested.


            Note: this is an estimate, and may be out of date.'
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/v2ConvertedValue'
        hasFrozenAssets:
          type: boolean
          example: true
          description: 'Some of the assets in this wallet are frozen due to a AML policy.

            Included only when `FULL` view is requested.'
          readOnly: true
        networks:
          type: array
          example:
          - networks/ethereum-mainnet
          items:
            type: string
          description: 'The resource names of the networks of the wallet. Can be set during creation and can be added later

            through the `CreateWalletAddress` method.'
        evmDetails:
          description: If this wallet contains an EVM network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/v2WalletEVMDetails'
        tronDetails:
          description: If this wallet contains a Tron network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/WalletTronDetails'
        tonDetails:
          description: If this wallet contains a Ton network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/v2WalletTonDetails'
        solanaDetails:
          description: If this wallet contains a Solana network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/WalletSolanaDetails'
        xrplDetails:
          description: If this wallet contains an XRPL network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/WalletXRPLDetails'
        createParams:
          description: Parameters only used during wallet creation. Not included in responses.
          allOf:
          - $ref: '#/components/schemas/WalletCreateParams'
        btcDetails:
          description: If this wallet contains a Bitcoin network, this field will be populated.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/v2WalletBTCDetails'
      required:
      - displayName
      - networks
    v2WalletTonDetails:
      type: object
      properties:
        address:
          type: string
          description: The address of the wallet.
          readOnly: true
    v2EVMTransactionGas:
      type: object
      properties:
        gasLimit:
          type: string
          format: int64
          description: The amount of gas to use for the transaction.
        gasUsed:
          type: string
          description: The amount of gas used by the transaction.
        gasPrice:
          type: string
          description: 'A `0x`-prefixed hex string representing the gas price of the transaction.


            Used for legacy transactions (non EIP-1559).'
        maxPriorityFeePerGas:
          type: string
          description: 'A `0x`-prefixed hex string representing the maximum prioriy fee per gas unit the transaction can pay.


            Used for dynamic transactions (EIP-1559).'
        maxFeePerGas:
          type: string
          description: 'A `0x`-prefixed hex string representing the maximum fee per gas unit the transaction can pay.


            Used for dynamic transactions (EIP-1559).'
    v2TransactionStellarTransactionMemo:
      type: object
      properties:
        type:
          description: The type of the memo.
          allOf:
          - $ref: '#/components/schemas/v2TransactionStellarTransactionMemoTypeEnum'
        data:
          type: string
          description: The data of the memo.
      required:
      - type
      - data
    v2TransactionTonProof:
      type: object
      properties:
        address:
          type: string
          description: 'The address of the signer.

            In Raw address format.


            Example: `0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef`.'
        appDomain:
          type: string
          title: The domain of the app requested the proof
        payload:
          type: string
          description: The payload to sign.
        timestamp:
          type: string
          format: int64
          description: The time at which the signature was created.
        signature:
          type: string
          description: The signature of the payload.
    TransactionTransitionValue:
      type: object
      properties:
        type:
          type: string
          description: '"record", "public", "private", or "future".'
        value:
          type: string
          description: Plaintext value (decrypted if private).
    v2TransactionTronTransactionWithdrawBalance:
      type: object
      properties:
        ownerAddress:
          description: 'The source of the transaction.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
    v2TransactionTronTransactionTronResourceEnum:
      type: string
      enum:
      - BANDWIDTH
      - ENERGY
    StellarTransactionDecodedOperationBody:
      type: object
      properties:
        payment:
          $ref: '#/components/schemas/StellarTransactionDecodedOperationBodyPayment'
        createAccount:
          $ref: '#/components/schemas/StellarTransactionDecodedOperationBodyCreateAccount'
        changeTrust:
          $ref: '#/components/schemas/StellarTransactionDecodedOperationBodyChangeTrust'
        sep41Payment:
          $ref: '#/components/schemas/StellarTransactionDecodedOperationBodySEP41Payment'
        sep41TokenApproval:
          $ref: '#/components/schemas/StellarTransactionDecodedOperationBodySEP41TokenApproval'
    v2TransactionTronTransactionDelegateResource:
      type: object
      properties:
        ownerAddress:
          description: 'The source of the transaction.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        resource:
          description: 'The resource to delegate.


            Can be one of the following:

            1. `BANDWIDTH`

            2. `ENERGY`'
          allOf:
          - $ref: '#/components/schemas/v2TransactionTronTransactionTronResourceEnum'
        amount:
          type: string
          example: '1500000'
          description: 'The amount of the resource to delegate, in SUN.


            Example: `1500000`.'
        asset:
          type: string
          example: assets/native.tron-mainnet
          description: 'The asset that is being delegated.


            Example: `assets/native.tron-mainnet`.'
        receiverAddress:
          description: 'The address to delegate the resource to.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        lock:
          type: boolean
          description: 'Whether to lock the delegation.


            Default: false.'
        lockPeriod:
          type: string
          description: 'The period to lock the delegation, in block numbers, 1 block ≈ 3 seconds.


            Example: `1000`.'
    TransactionXRPLTransaction:
      type: object
      properties:
        jsonTransactionData:
          type: object
          readOnly: true
    TransactionStellarTransactionStellarTimeBounds:
      type: object
      properties:
        minUnixTime:
          type: string
          format: int64
        maxUnixTime:
          type: string
          format: int64
    v2QueryBalancesResponse:
      type: object
      properties:
        balances:
          type: array
          items:
            $ref: '#/components/schemas/v2Balance'
          description: The balances returned.
        nextPageToken:
          type: string
          description: 'A token, which can be sent as `pageToken` to retrieve the next page.

            If this field is omitted, there are no subsequent pages.'
        totalSize:
          type: integer
          format: int32
          description: Total number of items in the response, regardless of pagination.
        referencedResources:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/v2ReferencedResource'
          description: 'A mapping of the referenced resources in the message.

            The key is the resource name and the value is the corresponding resource.'
    v2ConvertedValue:
      type: object
      properties:
        amount:
          type: string
          description: The amount in USD.
          readOnly: true
        currencyCode:
          type: string
          description: The currency code of the amount. Always USD.
          readOnly: true
      description: A message representing a converted value.
    v2AMLActionEnum:
      type: string
      enum:
      - DENY
      - ALLOW
      - ALERT
    v2TransactionSuiSignPersonalMessage:
      type: object
      properties:
        signer:
          description: The address of the signer.
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        message:
          type: string
          format: byte
          description: The message to sign.
        signature:
          type: string
          format: byte
          description: The signature of the message.
    TransactionJoinOperation:
      type: object
      properties:
        owner:
          $ref: '#/components/schemas/apiv2Address'
        inputs:
          type: array
          items:
            $ref: '#/components/schemas/TransactionAleoRecord'
        outputs:
          type: array
          items:
            $ref: '#/components/schemas/TransactionAleoRecord'
      description: credits.aleo/join — multiple records merged into one or more outputs.
    v2TransactionSolanaTransaction:
      type: object
      properties:
        fee:
          type: string
          description: Transaction fee in lamports.
        rawTransaction:
          type: string
          format: byte
          description: 'The full transaction payload, serialized.


            The message and signatures, encoded in base64 format.'
        utilaSigners:
          type: array
          items:
            $ref: '#/components/schemas/apiv2Address'
          description: 'The utila addresses used to sign the transaction.


            Must be the same length as request.signing_sessions.'
        replaceBlockhash:
          type: boolean
          description: Indicates whether the recent blockhash was or will be replaced with the most recent blockhash before signing.
    TransactionTonTransaction:
      type: object
      properties:
        sender:
          description: Ths source address of the transaction.
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        seqno:
          type: string
          format: int64
          description: The sequence number of the transaction.
        messages:
          type: array
          items:
            $ref: '#/components/schemas/TransactionTonTransactionMessage'
          title: The messages posted to the blockchain
        memo:
          type: string
          description: The memo of the transaction.
        validUntil:
          type: string
          format: int64
          description: The time the transaction is valid until.
        amount:
          type: string
          description: The native amount passed to the transaction.
    v2WalletAddressBalance:
      type: object
      properties:
        asset:
          type: string
          example: assets/native.ethereum-mainnet
          description: 'The resource name of the asset.


            Format: `assets/{asset_id}`'
        walletAddress:
          type: string
          example: vaults/1b25635a5b3f/wallets/203809def2/addresses/519c67ddae33
          description: 'The resource name of the wallet address.


            Format: `vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}`'
        value:
          type: string
          example: '1.3'
          description: The amount of the asset, in decimal form with precision included.
        rawValue:
          type: string
          example: '13000000'
          description: 'The raw amount of the asset that this balance contains.


            Specified in the smallest unit of the Asset.'
        frozenValue:
          type: string
          example: '0.3'
    TransactionFeePublic:
      type: object
      properties:
        amountMicrocredits:
          type: string
        priorityFeeMicrocredits:
          type: string
        payer:
          $ref: '#/components/schemas/apiv2Address'
      description: Public fee transition details.
    WalletSolanaDetails:
      type: object
      properties:
        address:
          type: string
          description: The address of the wallet.
          readOnly: true
    v2TransactionTronTransactionFreezeBalanceV2:
      type: object
      properties:
        ownerAddress:
          description: 'The source of the transaction.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
        amount:
          type: string
          example: '1500000'
          description: 'Amount of TRX to be staked, in SUN.


            Example: `1500000`.'
        resource:
          description: 'The resource to freeze.


            Can be one of the following:

            1. `BANDWIDTH`

            2. `ENERGY`'
          allOf:
          - $ref: '#/components/schemas/v2TransactionTronTransactionTronResourceEnum'
        asset:
          type: string
          example: assets/native.tron-mainnet
          description: 'The asset that is being staked.


            Example: `assets/native.tron-mainnet`.'
    v2TransactionTronTransactionWithdrawExpireUnfreeze:
      type: object
      properties:
        ownerAddress:
          description: 'The source of the transaction.


            A base58 string address (example: `TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g`)'
          allOf:
          - $ref: '#/components/schemas/apiv2Address'
    v2WalletAddress:
      type: object
      properties:
        name:
          type: string
          example: vaults/1b25635a5b3f/wallets/67af44031584/addresses/519c67ddae33
          description: 'The resource name of the WalletAddress.


            Format: `vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}`'
          readOnly: true
        displayName:
          type: string
          example: Hal's Address 3
          description: 'A human-readable name.

            Relevant only for deposit addresses.


            Must match the regular expression `[a-zA-Z0-9\.,:\-''# _$]+$` and be shorter than 100 characters'
        network:
          type: string
          example: networks/bitcoin-mainnet
          description: 'The resource name of the network of the address.


            Format: `networks/{network_id}`'
        address:
          type: string
          example: bc1q04pum57enmfgcu3tu5gwqlmza5n7tchky0gjvu
          description: The blockchain address.
          readOnly: true
        format:
          example: BITCOIN_P2WPKH
          description: Address format.
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/WalletAddressFormat'
        key:
          type: string
          example: vaults/1b25635a5b3f/keys/95257c5a522f
          description: 'The resource name of the MPC key this address was derived from.


            Format: `vaults/{vault_id}/keys/{key_id}`'
          readOnly: true
        keyDerivationPath:
          type: array
          example:
          - 44
          - 0
          - 0
          - 0
          - 3
          items:
            type: string
            format: int64
          description: Derivation path of the address from the MPC key.
          readOnly: true
        type:
          example: DEPOSIT
          readOnly: true
          allOf:
          - $ref: '#/components/schemas/v2WalletAddressType'
        note:
          type: string
          example: This is a note
          title: note
      required:
      - network
    TransactionThetaTransaction:
      type: object
      properties:
        sendTransaction:
          description: A send transaction that transfers THETA and TFUEL coins between addresses.
          allOf:
          - $ref: '#/components/schemas/ThetaTransactionSendTransaction'
      description: 'For Theta transaction: Low level transaction details.'
    WalletAddressFormat:
      type: string
      enum:
      - BITCOIN_P2PKH
      - BITCOIN_P2WPKH
      - EVM
      - TRON_BASE58
      - BASE58
      - TON_NON_BOUNCEABLE
      - SUBSTRATE_58
      - BITCOIN_P2TR
      description: " - BITCOIN_P2PKH: Bitcoin P2PKH address format.\n - BITCOIN_P2WPKH: Bitcoin P2WPKH address format.\n - EVM: Ethereum address format.\n - TRON_BASE58: Tron base58 address format.\n - BASE58: Solana address format.\n - TON_NON_BOUNCEABLE: Ton address format.\n - SUBSTRATE_58: Substrate address format.\n - BITCOIN_P2TR: Bitcoin P2TR (Taproot, BIP-341) address format."
    v2TransactionStateEnum:
      type: string
      enum:
      - AWAITING_APPROVAL
      - AWAITING_AML_POLICY_CHECK
      - DECLINED_BY_AML_POLICY
      - AWAITING_POLICY_CHECK
      - AWAITING_SIGNATURE
      - SIGNED
      - AWAITING_PUBLISH
      - PUBLISHED
      - MINED
      - MINED_FAILED
      - FAILED
      - DECLINED
      - REPLACED
      - CANCELED
      - DROPPED
      - CONFIRMED
      - EXPIRED
      description: "The state of the transaction.\n\n - AWAITING_APPROVAL: Transaction requires approving votes.\n - AWAITING_AML_POLICY_CHECK: The transaction is waiting for the AML policy check to be completed.\nRelevant only for outgoing transactions.\n - DECLINED_BY_AML_POLICY: Transaction was declined by the AML policy Relevant only for outgoing transactions.\n - AWAITING_POLICY_CHECK: Transaction is waiting for the policy check to be completed.\n - AWAITING_SIGNATURE: Transaction is approved and ready to be signed.\n - SIGNED: Transaction is signed but not yet published.\n - AWAITING_PUBLISH: Transaction has been sent to the publishing queue.\n - PUBLISHED: Transaction has been published to the blockchain's mem-pool.\n - MINED: Transaction has been included in a block successfully.\n - MINED_FAILED: Transaction has entered a block but in a failed state (e.g. a failed smart contract call).\n - FAILED: Transaction has entered a block but in a failed state and was confirmed as such by multiple blocks\n - DECLINED: Transaction was declined by a policy check.\n - REPLACED: Transaction was replaced by a new transaction (same nonce or RBF).\n - CANCELED: Transaction was canceled by its initiator or by an admin.\n - DROPPED: Transaction was dropped by the network without being included in a block.\n - CONFIRMED: Transaction has been confirmed by multiple blocks in the blockchain.\n - EXPIRED: Transaction was expired after a certain amount of time."
    v2TransactionEVMTransactionAuthorizationDetails:
      type: object
      properties:
        authorizationList:
          type: array
          items:
            $ref: '#/components/schemas/v2TransactionEVMTransactionAuthorization'
          description: The list of authorizations.
    v2ReferencedResource:
      type: object
      properties:
        asset:
          description: The asset resource.
          allOf:
          - $ref: '#/components/schemas/v2Asset'
        wallet:
          description: The wallet resource.
          allOf:
          - $ref: '#/components/schemas/v2Wallet'
        walletAddress:
          description: The wallet address resource.
          allOf:
          - $ref: '#/components/schemas/v2WalletAddress'
        user:
          description: The user resource.
          allOf:
          - $ref: '#/components/schemas/v2User'
        walletconnectSession:
          description: The wallet connect session resource.
          allOf:
          - $ref: '#/components/schemas/v2WalletconnectSession'
        addressBookEntry:
          description: The addressbook entry resource.
          allOf:
          - $ref: '#/components/schemas/v2AddressBookEntry'
        transaction:
          description: the transaction entry resource.
          allOf:
          - $ref: '#/components/schemas/v2Transaction'
    v2QueryWalletUTXOsResponse:
      type: object
      properties:
        utxos:
          type: array
          items:
            $ref: '#/components/schemas/apiv2UTXO'
          description: The UTXOs returned.
        nextPageToken:
          type: string
          description: 'A token, which can be sent as `pageToken` to retrieve the next page.

            If this field is omitted, there are no subsequent pages.'
        totalSize:
          type: integer
          format: int32
          description: Total number of items in the response, regardless of pagination.
        referencedResources:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/v2ReferencedResource'
          description: 'A mapping of the referenced resources in the message.

            The key is the resource name and the value is the corresponding resource.


            This field is only populated if the `includeReferencedResources` field is set to `true`.'
    v2QueryWalletBalancesResponse:
      type: object
      properties:
        walletBalances:
          type: array
          items:
            $ref: '#/components/schemas/v2WalletBalance'
          description: The balances returned.
        nextPageToken:
          type: string
          description: 'A token, which can be sent as `pageToken` to retrieve the next page.

            If this field is omitted, there are no subsequent pages.'
        totalSize:
          type: integer
          format: int32
          description: Total number of items in the response, regardless of pagination.
        referencedResources:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/v2ReferencedResource'
          description: 'A mapping of the referenced resources in the message.

            The key is the resource name and the value is the corresponding resource.


            This field is only populated if the `includeReferencedResources` field is set to `true`.'
    v2TransactionTypeEnum:
      type: string
      enum:
      - TRANSACTION
      - MESSAGE
    WalletconnectSessionPeer:
      type: object
      properties:
        uri:
          type: string
          description: The URI of the peer.
        name:
          type: string
          description: The name of the peer.
        description:
          type: string
          description: The description of the peer.
        icon:
          type: string
          description: The icon of the peer.
    v2TronResourceFee:
      type: object
      properties:
        consumed:
          type: string
          description: The amount of the resource consumed.
        burned:
          type: string
          description: The amount of TRX burned for this resource.
        convertedBurned:
          description: The converted (fiat) value of the TRX burned for this resource.
          allOf:
          - $ref: '#/components/schemas/v2ConvertedValue'
      description: Resource-level fee breakdown for a Tron resource (bandwidth or energy).
    BalancesQueryWalletBalancesBody:
      type: object
      properties:
        filter:
          type: string
          description: 'Filter results using EBNF syntax.


            Supported functions:

            * `asset(asset_name)` (example: `asset("assets/native.ethereum-mainnet")`)

            * `network(network_name)` (example: `network("networks/ethereum-mainnet")`)

            * `wallet_external()` (example: `wallet_external()`)'
        pageSize:
          type: integer
          format: int32
          description: The maximum number of items to return. The service may return fewer than this value.
        pageToken:
          type: string
          description: A page tok

# --- truncated at 32 KB (98 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/utila/refs/heads/main/openapi/utila-balances-api-openapi.yml