> ## 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 usage statistics



## OpenAPI

````yaml /openapi/public-gateway.json get /v1/usage
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/usage:
    get:
      tags:
        - Metrics
      summary: Wallet usage
      operationId: usageStats
      parameters:
        - name: address
          in: query
          required: true
          description: Wallet address.
          schema:
            type: string
          example: '0xabc123'
        - name: period
          in: query
          required: false
          description: Usage period.
          schema:
            type: string
            enum:
              - today
              - week
              - month
              - all
            default: all
          example: week
      responses:
        '200':
          description: Wallet usage totals grouped by API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponse'
components:
  schemas:
    UsageResponse:
      type: object
      properties:
        total_requests:
          type: integer
        total_spent_usdc:
          type: number
        period:
          type: string
        by_api:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ApiUsageStats'
    ApiUsageStats:
      type: object
      properties:
        requests:
          type: integer
        spent_usdc:
          type: number

````