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

# Get account balance

> Returns the current balance and daily spend information for the authenticated account, split by mainnet and testnet.



## OpenAPI

````yaml get /balance
openapi: 3.0.0
info:
  title: HTTPayer Proxy API
  version: 1.0.0
  description: >-
    HTTPayer is a payment router for 402 response codes and the x402 Protocol.
    Users can access APIs that use the x402 standard through the HTTPayer proxy.
  contact:
    name: HTTPayer Team
    url: https://httpayer.com
servers:
  - url: https://api.httpayer.com
    description: Production server
security: []
tags:
  - name: Relay
    description: Cross-chain payment relay endpoints
  - name: Account
    description: Account balance and limits endpoints
  - name: Webhooks
    description: Async task status and webhooks
  - name: LLM
    description: OpenAI-powered endpoints for translation and chat
  - name: Health
    description: Health check endpoints
paths:
  /balance:
    get:
      tags:
        - Account
      summary: Get account balance
      description: >-
        Returns the current balance and daily spend information for the
        authenticated account, split by mainnet and testnet.
      parameters: []
      responses:
        '200':
          description: Account balance information
          content:
            application/json:
              schema:
                type: object
                properties:
                  account_id:
                    type: string
                    description: Account identifier
                  mainnet:
                    type: object
                    description: >-
                      Mainnet credit balance and daily spend (credits deducted
                      for mainnet only)
                    properties:
                      credits_balance:
                        type: number
                        description: >-
                          Current account balance in credits (1 credit = 0.001
                          USDC)
                        example: 50000
                      daily_limit:
                        type: number
                        description: Maximum credits that can be spent per day
                        example: 100000
                      daily_spend:
                        type: number
                        description: Credits spent today
                        example: 15500
                      daily_remaining:
                        type: number
                        description: Credits remaining for today
                        example: 84500
                  testnet:
                    type: object
                    description: >-
                      Testnet daily volume tracking (no credits deducted, but
                      per-account volume cap applies)
                    properties:
                      daily_limit_usd:
                        type: number
                        description: Maximum USDC volume per day on testnet
                        example: 500
                      today_spent_usd:
                        type: number
                        description: USDC volume used today on testnet
                        example: 12.5
                      remaining_usd:
                        type: number
                        description: USDC volume remaining for today on testnet
                        example: 487.5
        '401':
          description: Unauthorized - invalid API key
        '404':
          description: Account not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type: string
          description: Additional error details
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````