---
title: "Public usage stats"
method: GET
path: "/v5/metrics"
---

# Public usage stats

`GET /v5/metrics`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/metrics`
- Auth: none declared

Returns today's MCP request totals and unique client count from ORACLE_TELEMETRY KV. No authentication required. Metrics are best-effort — KV unavailability returns zeros rather than 500.

## Response `200`

Usage statistics

- object
  - `total_mcp_requests_today` integer, required: Sum of all MCP request_count values for today.
  - `unique_mcp_clients_today` integer, required: Distinct MCP client IPs seen today (hashed).
  - `exchanges_covered` integer, required
  - `edge_cases_per_year` integer, required
  - `uptime_status` 'operational', required

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)