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

# Get public API stats

> Returns metadata-only request counters, route latency summaries, error codes, and the Firebase-compatible api_request event schema for the current public API container process. For durable history, consume the structured public API request logs.



## OpenAPI

````yaml /reference/public-openapi.json get /v1/monitoring/public-api/stats
openapi: 3.1.0
info:
  title: Nova Security, Bridge, Token & Wallet API
  version: '2026-05-27'
  description: >-
    Open public APIs for Nova security checks, Relay-backed bridge route quotes,
    and on-chain intelligence.
servers:
  - url: https://api-nova.tech
    description: Public API
security: []
tags:
  - name: Security Model
    description: >-
      Risk checks for tokens, wallets, dapps, transactions, permissions, and
      addresses.
  - name: Nova Bridge
    description: >-
      Build wallet-ready Relay route quotes. Wallet approvals, signing, and
      broadcast stay local.
  - name: Token Data
    description: Search, profiles, prices, charts, and trending token data.
  - name: Wallet Data
    description: Public wallet overview, holdings, trades, and activity.
  - name: Trader Data
    description: Leaderboards, trade feeds, and token signals.
  - name: Monitoring
    description: Metadata-only public API request stats and scrapeable metrics.
paths:
  /v1/monitoring/public-api/stats:
    get:
      tags:
        - Monitoring
      summary: Get public API stats
      description: >-
        Returns metadata-only request counters, route latency summaries, error
        codes, and the Firebase-compatible api_request event schema for the
        current public API container process. For durable history, consume the
        structured public API request logs.
      operationId: getPublicApiStats
      parameters:
        - name: includeRecent
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Include the most recent sanitized request events.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Maximum recent event count when includeRecent is true.
      responses:
        '200':
          description: Current public API stats.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiStatsResponse'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    PublicApiStatsResponse:
      type: object
      required:
        - service
        - generatedAt
        - windowStartedAt
        - deployment
        - summary
        - statusClasses
        - errors
        - clientTypes
        - trafficClasses
        - countries
        - edgeRegions
        - routes
        - firebaseEventSchema
      properties:
        service:
          type: string
          example: nova_public_api
        generatedAt:
          type: string
          format: date-time
        windowStartedAt:
          type: string
          format: date-time
        deployment:
          type: object
          required:
            - sha
          properties:
            sha:
              type: string
              example: unknown
          additionalProperties: false
        summary:
          type: object
          required:
            - totalRequests
            - successCount
            - errorCount
            - actionableRequestCount
            - actionableErrorCount
            - noiseRequestCount
            - noiseErrorCount
            - rateLimitedCount
            - avgLatencyMs
            - p50LatencyMs
            - p95LatencyMs
            - p99LatencyMs
          properties:
            totalRequests:
              type: integer
              minimum: 0
            successCount:
              type: integer
              minimum: 0
            errorCount:
              type: integer
              minimum: 0
            actionableRequestCount:
              type: integer
              minimum: 0
            actionableErrorCount:
              type: integer
              minimum: 0
            noiseRequestCount:
              type: integer
              minimum: 0
            noiseErrorCount:
              type: integer
              minimum: 0
            rateLimitedCount:
              type: integer
              minimum: 0
            avgLatencyMs:
              type: integer
              minimum: 0
            p50LatencyMs:
              type: integer
              minimum: 0
            p95LatencyMs:
              type: integer
              minimum: 0
            p99LatencyMs:
              type: integer
              minimum: 0
          additionalProperties: false
        statusClasses:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        errors:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        clientTypes:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        trafficClasses:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        countries:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        edgeRegions:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
        routes:
          type: array
          items:
            $ref: '#/components/schemas/PublicApiRouteStats'
        firebaseEventSchema:
          type: object
          required:
            - eventName
            - paramNames
            - example
          properties:
            eventName:
              type: string
              enum:
                - api_request
            paramNames:
              type: array
              items:
                type: string
            example:
              $ref: '#/components/schemas/PublicApiFirebaseParams'
          additionalProperties: false
        recentEvents:
          type: array
          items:
            type: object
            required:
              - observedAt
              - requestId
              - firebaseEvent
            properties:
              observedAt:
                type: string
                format: date-time
              requestId:
                type: string
              firebaseEvent:
                $ref: '#/components/schemas/PublicApiFirebaseEvent'
            additionalProperties: false
      additionalProperties: false
    PublicApiRouteStats:
      type: object
      required:
        - method
        - route
        - count
        - successCount
        - errorCount
        - rateLimitedCount
        - statusCodes
        - statusClasses
        - errors
        - trafficClasses
        - avgLatencyMs
        - p50LatencyMs
        - p95LatencyMs
        - p99LatencyMs
        - lastSeenAt
      properties:
        method:
          type: string
          example: GET
        route:
          type: string
          example: /v1/data/tokens/search
        count:
          type: integer
          minimum: 0
        successCount:
          type: integer
          minimum: 0
        errorCount:
          type: integer
          minimum: 0
        rateLimitedCount:
          type: integer
          minimum: 0
        statusCodes:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
          example:
            '200': 12
        statusClasses:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
          example:
            2xx: 12
        errors:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
          example: {}
        trafficClasses:
          type: object
          additionalProperties:
            type: integer
            minimum: 0
          example:
            product: 12
        avgLatencyMs:
          type: integer
          minimum: 0
        p50LatencyMs:
          type: integer
          minimum: 0
        p95LatencyMs:
          type: integer
          minimum: 0
        p99LatencyMs:
          type: integer
          minimum: 0
        lastSeenAt:
          type: string
          format: date-time
      additionalProperties: false
    PublicApiFirebaseParams:
      type: object
      required:
        - api_service
        - api_method
        - api_route
        - api_status
        - api_status_class
        - api_latency_ms
        - api_success
        - api_error_code
        - api_rate_bucket
        - api_client_type
        - api_traffic_class
        - api_country
        - api_edge_region
        - api_deploy_sha
      properties:
        api_service:
          type: string
          example: nova_public_api
        api_method:
          type: string
          example: GET
        api_route:
          type: string
          example: /v1/data/tokens/search
        api_status:
          type: integer
          example: 200
        api_status_class:
          type: string
          example: 2xx
        api_latency_ms:
          type: integer
          minimum: 0
          example: 42
        api_success:
          type: integer
          enum:
            - 0
            - 1
          example: 1
        api_error_code:
          type: string
          example: none
        api_rate_bucket:
          type: string
          example: standard
        api_client_type:
          type: string
          example: docs
        api_traffic_class:
          type: string
          example: product
        api_country:
          type: string
          example: US
        api_edge_region:
          type: string
          example: unknown
        api_deploy_sha:
          type: string
          example: unknown
      additionalProperties: false
    PublicApiFirebaseEvent:
      type: object
      required:
        - name
        - params
      properties:
        name:
          type: string
          enum:
            - api_request
        params:
          $ref: '#/components/schemas/PublicApiFirebaseParams'
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: RATE_LIMITED
            message:
              type: string
              example: Too many requests. Try again later.
            requestId:
              type: string
          additionalProperties: false
      additionalProperties: false
  responses:
    RateLimited:
      description: The request exceeded an IP, endpoint, or capability quota.
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait before retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````