> ## Documentation Index
> Fetch the complete documentation index at: https://dev.commerce.moonpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Withdrawal Balances

> Returns on-chain balances for a wallet address against the withdrawal config's source currencies. No authentication required (rate-limited, cached ~5s).

> [!TIP]
>
> For HyperCore configs, show `maxWithdrawableAmount` as the limit and pass the same `hyperCoreLane` you'll send to prepare, so the reserve matches the lane (see [Choose the lane](https://dev.commerce.moonpay.com/docs/withdrawals.md#choose-the-lane)).


## OpenAPI

````yaml GET /v1/withdraw/{withdrawalConfigId}/balances
openapi: 3.0.0
info:
  title: Helio Open API
  description: |-
    API schema and definitions for Helio API. <br/> 
          The API is using two types of Authentication, for dashboard endpoints we use <b>JSON Web Token (JWT)</b> that is generated by self custodial wallet signing a message from API.</br> 
          We also support authentication with <b>API Key and Secret</b> which can be generated on <a href='https://hel.io'>Helio dashboard</a>.
  version: 1.0.0
  contact: {}
servers:
  - description: Helio API (Mainnet)
    url: https://api.hel.io
security: []
tags:
  - name: Webhooks
  - name: Exports
  - name: Currencies
    description: >-
      Supported currencies endpoint, includes fiat and digital assets
      </br><i>Authentication: </i><b>None</b>
externalDocs:
  description: Helio product documentation
  url: https://dev.commerce.moonpay.com/
paths:
  /v1/withdraw/{withdrawalConfigId}/balances:
    get:
      tags:
        - Withdrawals
      summary: Get Withdrawal Balances
      description: >-
        Returns on-chain balances for a wallet address against the withdrawal
        config's source currencies. No authentication required (rate-limited,
        cached ~5s).
      operationId: WithdrawalBalancesController_listBalances
      parameters:
        - name: withdrawalConfigId
          in: path
          required: true
          description: The withdrawal config ID.
          schema:
            type: string
        - name: walletAddress
          in: query
          required: true
          description: Wallet address (holder pubkey) to read balances for.
          schema:
            type: string
        - name: hyperCoreLane
          in: query
          required: false
          description: >-
            HyperCore USDC only: pass the lane you will prepare with so
            `maxWithdrawableAmount` matches it. Defaults to `native`.
          schema:
            $ref: '#/components/schemas/HyperCoreWithdrawalLane'
      responses:
        '200':
          description: Balances retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WithdrawalBalancesResponse'
        '404':
          description: Withdrawal config not found.
      security: []
components:
  schemas:
    HyperCoreWithdrawalLane:
      type: string
      enum:
        - native
        - eip3009
      description: >-
        HyperCore USDC withdrawals only. `native` (default) returns a
        `hypercore` prepared transaction. `eip3009` opts into the
        `hypercore_eip3009` route, which is used only when it's enabled for your
        account and the destination is routable; otherwise the withdrawal stays
        `native`. Send the same value on routes, balances and prepare.
    WithdrawalBalancesResponse:
      type: object
      properties:
        walletAddress:
          type: string
          description: Address balances were read against.
        balances:
          type: array
          items:
            $ref: '#/components/schemas/WalletCurrencyBalance'
    WalletCurrencyBalance:
      type: object
      properties:
        currencyId:
          type: string
        symbol:
          type: string
        mintAddress:
          type: string
        balance:
          type: string
          nullable: true
          description: Atomic balance.
        uiBalance:
          type: string
          nullable: true
          description: Human-readable balance.
        maxWithdrawableAmount:
          type: string
          nullable: true
          description: >-
            Maximum withdrawable amount in atomic units after network or gas
            fees.
        uiMaxWithdrawableAmount:
          type: string
          nullable: true
          description: Human-readable max withdrawable amount.

````