---
title: "Public telemetry metadata or operator-authorized aggregate detail"
method: GET
path: "/v1/stats"
tags: ["Status"]
---

# Public telemetry metadata or operator-authorized aggregate detail

`GET /v1/stats`

## Request

- Base URL: `https://api.m2msentinel.com`
- URL: `https://api.m2msentinel.com/v1/stats`
- Auth: none required

Without operator authorization this returns no exact adoption, funnel, utilization, attribution, or revenue counters. A Bearer OPERATOR_STATS_TOKEN returns identifier-free global daily counters. No IP address, wallet, API key, contract address, path parameter, user agent, referrer, or per-user identifier is collected.

## Query parameters

- `days` integer
- `bucket` 'production' | 'test'

## Response `200`

Redacted public metadata, or detailed counters when operator-authorized

- union
  - PublicStats
    - `status` 'SUCCESS', required
    - `windowDays` integer, required
    - `generatedAt` string, date-time, required
    - `privacy` string, required
    - `detailAccess` string, required
  - AggregateStats
    - `status` 'SUCCESS', required
    - `bucket` 'production' | 'test', required: Which analytics bucket produced these counters. 'test' is authenticated non-customer probe traffic and must never be reported as customer conversion.
    - `windowDays` integer, required
    - `generatedAt` string, date-time, required
    - `totals` object, required
      - `demoRequested` integer
      - `demoSucceeded` integer
      - `demoUnsupported` integer
      - `demoSampleServed` integer: Successful responses for the published allowlisted sample route. No caller identifier is retained.
      - `demoPreviewServed` integer: Successful reduced previews for arbitrary-address demo requests. The full paid audit payload is not included.
      - `paymentChallengeIssued` integer
      - `x402PaymentSignaturePresented` integer: x402 PAYMENT-SIGNATURE headers presented on a payable route. This aggregate ingress count can include malformed or rejected input, does not identify unique buyers, and is not payment confirmation.
      - `x402PaymentVerified` integer: Signed x402 requests for which the facilitator returned a valid verification result.
      - `x402PaymentVerificationFailed` integer: Signed x402 requests whose verification did not succeed; the counter does not distinguish an invalid payment from a facilitator exception.
      - `x402Settled` integer
      - `x402SettlementFailed` integer: Verified x402 requests for which the facilitator explicitly returned a failed settlement result.
      - `x402SettlementUnknown` integer: Verified x402 requests whose settlement raised a timeout, transport, or protocol exception. UNKNOWN is not proof that settlement failed.
      - `x402PaymentCanceled` integer: Verified x402 requests canceled before settlement because the protected handler failed or threw.
      - `authenticatedDecisionServed` integer
      - `freeChallengeCreated` integer
      - `freeKeyIssued` integer
      - `subscriptionIntentCreated` integer
      - `subscriptionKeyIssued` integer
      - `subscriptionRenewed` integer
      - `keyRecovered` integer
      - `quotaExhausted` integer
      - `x402RevenueMicrousd` integer
      - `subscriptionRevenueMicrousd` integer
    - `productEvents` object[]
    - `revenue` object, required
      - `x402Usd` number
      - `subscriptionsUsd` number
    - `diagnostics` object: Authenticated operator-only natural failure diagnostics. Contains detailed records and aggregate summary.
      - `summary` NaturalDiagnosticSummary: Sanitized aggregate summary of natural failure diagnostics. Exposes only closed-vocabulary counts and bounds, never raw records.
        - `totalRecorded` integer, required
        - `bySourceClass` object, required
        - `byRouteClass` object, required
        - `byOutcomeCode` object, required
        - `byFailureClass` object, required
        - `byLatencyBucket` object, required
        - `generatedAt` string, date-time, required
      - `records` NaturalDiagnosticRecord[]
        - `timestamp` string, date-time, required
        - `sourceClass` 'synthetic_monitor' | 'genuine_route_attempt', required
        - `routeClass` 'audit' | 'score' | 'gasFees' | 'dexMetrics' | 'tokenPrice' | 'whaleSignals' | 'transactionPreflight' | 'status' | 'plans' | 'subscribe' | 'keys' | 'demo' | 'events' | 'mcp' | 'health_cron' | 'other', required
        - `httpStatus` integer, nullable, required
        - `outcomeCode` 'OK' | 'CHALLENGE_ISSUED' | 'SETTLED' | 'SETTLEMENT_FAILED' | 'SETTLEMENT_UNKNOWN' | 'INVALID_CHALLENGE' | 'MISSING_CHALLENGE' | 'READINESS_TIMEOUT' | 'FAIL_CLOSED_UNAVAILABLE' | 'UNEXPECTED_HTTP_STATUS' | 'RATE_LIMITED' | 'QUOTA_EXHAUSTED' | 'UNAUTHORIZED' | 'BAD_REQUEST' | 'TIMEOUT' | 'NETWORK_ERROR' | 'SKIPPED_CONFIG_GATE' | 'SKIPPED_QUOTA_GUARD' | 'NOT_CONFIGURED' | 'UNKNOWN_OUTCOME', required
        - `failureClass` 'READINESS_TIMEOUT' | 'FAIL_CLOSED_UNAVAILABLE' | 'SETTLEMENT_FAILED' | 'SETTLEMENT_TIMEOUT' | 'FACILITATOR_ERROR' | 'HTTP_4XX' | 'HTTP_5XX' | 'TIMEOUT' | 'NETWORK_ERROR' | 'RATE_LIMITED' | 'QUOTA_EXHAUSTED' | 'AUTH_FAILURE' | 'BAD_REQUEST' | 'DATA_SOURCE_UNAVAILABLE' | 'UNKNOWN_FAILURE' | 'null', nullable, required
        - `releaseCohort` string, required
        - `latencyBucket` '<50ms' | '50-100ms' | '100-250ms' | '250-500ms' | '500-1000ms' | '1-2s' | '2-5s' | '>5s' | 'UNKNOWN', required
    - `privacy` string, required

## Other responses

- `429`: A plan burst limit or bounded public/intent retry limit was exceeded

---

[API](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign.md) · [All operations](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/llms.txt) · [OpenAPI document](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/revisions/2dadd4e704fd?raw)