Skip to main content
The GET /api/metrics endpoint returns detailed usage analytics — token consumption, request counts, and cost breakdowns by model and time period.

​
Endpoint

GET https://api.lightweight.one/api/metrics

curl "https://api.lightweight.one/api/metrics" \
  -H "Authorization: Bearer lw_sk_your-key-here"

​
Query Parameters

ParameterTypeRequiredDescription
periodstringNoTime period to aggregate. Options: hour, day, week, month. Defaults to day.
modelstringNoFilter metrics to a specific model ID (e.g. claude-sonnet-4.5).

​
Response Format

{
  "period": "day",
  "start": "2026-03-24T00:00:00Z",
  "end": "2026-03-25T00:00:00Z",
  "totals": {
    "requests": 1542,
    "input_tokens": 3250000,
    "output_tokens": 890000,
    "total_tokens": 4140000,
    "cost_usd": 12.45
  },
  "by_model": [
    {
      "model": "claude-sonnet-4.5",
      "requests": 820,
      "input_tokens": 1800000,
      "output_tokens": 520000,
      "total_tokens": 2320000,
      "cost_usd": 7.80
    },
    {
      "model": "gpt-5.4",
      "requests": 450,
      "input_tokens": 950000,
      "output_tokens": 280000,
      "total_tokens": 1230000,
      "cost_usd": 3.55
    },
    {
      "model": "gemini-2.5-pro",
      "requests": 272,
      "input_tokens": 500000,
      "output_tokens": 90000,
      "total_tokens": 590000,
      "cost_usd": 1.10
    }
  ]
}

​
Example Requests

​
Default — Last Day

curl "https://api.lightweight.one/api/metrics" \
  -H "Authorization: Bearer lw_sk_your-key-here"

​
Last Week

curl "https://api.lightweight.one/api/metrics?period=week" \
  -H "Authorization: Bearer lw_sk_your-key-here"

​
Filtered by Model

curl "https://api.lightweight.one/api/metrics?model=claude-sonnet-4.5&period=month" \
  -H "Authorization: Bearer lw_sk_your-key-here"

​
Last Hour

curl "https://api.lightweight.one/api/metrics?period=hour" \
  -H "Authorization: Bearer lw_sk_your-key-here"
For a quick overview of your remaining quota, use GET /v1/usage instead. The Metrics API is for detailed analytics and cost tracking.