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

# Get Wallet Balance by Currency

> Gets the balance of your business wallet in one currency, for example USD.



## OpenAPI

````yaml /novacrust-open-api-v2.yaml get /api/v1/business/open/wallets/{currency}
openapi: 3.0.0
info:
  title: Open-API
  description: The http Integration API description
  version: '1.0'
  contact: {}
servers:
  - url: http://localhost:3050
    description: Local environment
  - url: https://api-staging.novacrust.com
    description: Staging environment
  - url: https://api-dev.novacrust.com
    description: Develop environment
security:
  - api-key: []
tags:
  - name: Customer
    description: ''
  - name: Payout Methods
    description: ''
  - name: Beneficiary
    description: ''
  - name: Payout
    description: ''
  - name: Transactions
    description: ''
  - name: Buy Gift Card
    description: ''
  - name: Sell Gift Card
    description: ''
  - name: Miscellaneous
    description: ''
  - name: Wallets
    description: ''
paths:
  /api/v1/business/open/wallets/{currency}:
    get:
      tags:
        - Wallets
      summary: Get Wallet Balance by Currency
      description: >-
        Gets the balance of your business wallet in one currency, for example
        USD.
      operationId: getBalance
      parameters:
        - name: currency
          required: true
          in: path
          description: ISO currency code. Not case-sensitive.
          schema:
            example: USD
            type: string
      responses:
        '200':
          description: Wallet balance retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiWalletBalanceResponse'
        '401':
          description: Missing or invalid API key
        '404':
          description: Your business has no wallet in this currency
components:
  schemas:
    OpenApiWalletBalanceResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Wallet balance retrieved successfully
        data:
          $ref: '#/components/schemas/OpenApiWalletBalanceDto'
      required:
        - success
        - message
        - data
    OpenApiWalletBalanceDto:
      type: object
      properties:
        wallet_id:
          type: string
          description: Unique identifier of the wallet.
          example: 5b1f0c1e-3c52-4c6c-9a35-6f0a1a2f7d10
        currency:
          type: string
          description: ISO currency code.
          example: USD
        symbol:
          type: string
          description: Currency symbol.
          example: $
        balance:
          type: string
          description: >-
            Current balance as a decimal string with up to 8 decimal places.
            Returned as a string so it is never rounded by JSON number handling.
          example: '1250.50000000'
        updated_at:
          type: string
          description: When the balance last changed.
          example: '2026-10-13T09:41:22.000Z'
      required:
        - wallet_id
        - currency
        - symbol
        - balance
        - updated_at
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.