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

# Get all stablecoin balances for an app

> Retrieves both USDC and EURC balances across all wallets for the specified app.
    
This comprehensive endpoint provides:
- Complete USDC balance aggregation with detailed breakdown
- Complete EURC balance aggregation with detailed breakdown
- Total USD equivalent value across both currencies
- Individual wallet and chain-specific balance details

## Use Cases
- Complete financial dashboard overview
- Multi-currency balance reporting
- Comprehensive wallet management
- Cross-currency analytics and reporting

## Response Format
The response includes separate aggregations for each currency plus a combined
USD value estimate, providing complete visibility into stablecoin holdings.



## OpenAPI

````yaml /swagger.yml get /api/v0/balance
openapi: 3.0.0
info:
  title: Devdraft AI Payment & Business Management API
  description: >-

    A comprehensive payment processing and business management API that enables
    seamless integration of cryptocurrency and traditional payment methods.
        
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.devdraft.ai
    description: Production Server
security: []
tags: []
paths:
  /api/v0/balance:
    get:
      tags:
        - App Balances
      summary: Get all stablecoin balances for an app
      description: >-
        Retrieves both USDC and EURC balances across all wallets for the
        specified app.
            
        This comprehensive endpoint provides:

        - Complete USDC balance aggregation with detailed breakdown

        - Complete EURC balance aggregation with detailed breakdown

        - Total USD equivalent value across both currencies

        - Individual wallet and chain-specific balance details


        ## Use Cases

        - Complete financial dashboard overview

        - Multi-currency balance reporting

        - Comprehensive wallet management

        - Cross-currency analytics and reporting


        ## Response Format

        The response includes separate aggregations for each currency plus a
        combined

        USD value estimate, providing complete visibility into stablecoin
        holdings.
      operationId: BalanceController_getAllBalances
      parameters: []
      responses:
        '200':
          description: All stablecoin balances retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllBalancesResponse'
        '401':
          description: Unauthorized - Invalid or missing API credentials
        '404':
          description: App not found or no access permission
        '500':
          description: Internal server error
      security:
        - x-client-secret: []
        - x-client-key: []
components:
  schemas:
    AllBalancesResponse:
      type: object
      properties:
        usdc:
          description: USDC balance aggregation
          allOf:
            - $ref: '#/components/schemas/AggregatedBalanceResponse'
        eurc:
          description: EURC balance aggregation
          allOf:
            - $ref: '#/components/schemas/AggregatedBalanceResponse'
        total_usd_value:
          type: string
          description: Total value in USD equivalent
          example: '6890.45'
      required:
        - usdc
        - eurc
        - total_usd_value
    AggregatedBalanceResponse:
      type: object
      properties:
        currency:
          type: string
          description: The stablecoin currency
          enum:
            - usdc
            - eurc
          example: usdc
        total_balance:
          type: string
          description: The total aggregated balance across all wallets and chains
          example: '5678.90'
        balances:
          description: Detailed breakdown of balances by wallet and chain
          items:
            type: object
          type: array
      required:
        - currency
        - total_balance
        - balances
  securitySchemes:
    x-client-secret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Your secret API key. Keep this secure and never expose it in client-side
        code.
    x-client-key:
      type: apiKey
      in: header
      name: x-client-key
      description: Your unique client API key. Obtain this from your Devdraft AI dashboard.

````