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

# Agent usage statistics

> Proxied by the gateway to the dashboard's
`/api/agent/usage` endpoint. Returns aggregated AI provider
usage, including token counts, request counts, and cost
estimates for the configured window.




## OpenAPI

````yaml /docs/openapi-minimal.yaml get /agent/usage
openapi: 3.0.3
info:
  title: Hoox API
  description: |
    REST API for the Hoox algorithmic trading platform.

    Ingest trade signals, check system health, and manage DeFi wallet
    operations on the Cloudflare edge. All requests are handled by the
    Hoox gateway worker (`workers/hoox`) running at the network edge.
  version: 1.0.0
  contact:
    name: Hoox Support
    email: support@hoox.sh
servers:
  - url: https://api.hoox.sh
    description: Production API
  - url: https://staging.hoox.sh
    description: Staging environment
security: []
paths:
  /agent/usage:
    get:
      tags:
        - AI Agent
      summary: Agent usage statistics
      description: |
        Proxied by the gateway to the dashboard's
        `/api/agent/usage` endpoint. Returns aggregated AI provider
        usage, including token counts, request counts, and cost
        estimates for the configured window.
      operationId: agentUsage
      responses:
        '200':
          description: Usage statistics returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  totalRequests:
                    type: integer
                    example: 1247
                  totalTokens:
                    type: integer
                    example: 384521
                  totalCostUsd:
                    type: number
                    format: float
                    example: 2.184
                  byProvider:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        requests:
                          type: integer
                        tokens:
                          type: integer
        '401':
          description: Internal authentication missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to retrieve usage statistics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        requestId:
          type: string
          format: uuid
          description: Request trace identifier
          example: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d
        error:
          type: string
          description: Human-readable error description
          example: Invalid JSON payload structure.

````