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

# Get wallet spend summary



## OpenAPI

````yaml /openapi/public-gateway.json get /v1/balance
openapi: 3.1.0
info:
  title: Apiosk Gateway Public API
  version: 1.1.0
  description: >-
    Sanitized public API reference for the Apiosk gateway. This document covers
    the integration contract for discovery, metadata, execution, payments, and
    community API publishing without exposing internal gateway implementation
    details.
servers:
  - url: https://gateway.apiosk.com
    description: Production gateway
security: []
tags:
  - name: Discovery
    description: Browse listing groups, APIs, and listing detail.
  - name: Execution
    description: Call APIs through public metadata and uniform execute routes.
  - name: Payments
    description: 'Public x402 boundary: 402 responses and payment proof header.'
  - name: Publishing
    description: Register, inspect, update, and deactivate community APIs.
  - name: Metrics
    description: Public wallet and traffic summary routes.
paths:
  /v1/balance:
    get:
      tags:
        - Metrics
      summary: Wallet balance
      operationId: checkBalance
      parameters:
        - name: address
          in: query
          required: true
          description: Wallet address.
          schema:
            type: string
          example: '0xabc123'
      responses:
        '200':
          description: Wallet spend summary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
components:
  schemas:
    BalanceResponse:
      type: object
      properties:
        address:
          type: string
        balance_usdc:
          type: number
        spent_today_usdc:
          type: number
        spent_week_usdc:
          type: number
        spent_month_usdc:
          type: number

````