GET /v1/usage/analytics

Credit usage grouped by endpoint. `period=billing` exists because the rolling window never lines up with what you are actually billed on: the credit counter is zeroed on the 1st of each month (/etc/cron.d/auodds-reset), so on the 18th a 30-day rolling total spans two allowances and cannot be reconciled against credits_used. The default stays `rolling` so no existing client changes behaviour. ⚠️ `period_days` is an int under `period=rolling` (it echoes `days`, unchanged) and a float under `period=billing`, where it is the measured length of the current period rather than a requested window — e.g. 31.0 for a period that started on the 1st. The widening only reaches callers who opt in by passing the new parameter; `period_start` and `period_end` are always returned so the window never has to be inferred from it.

Request

curl 'https://api.puntersedge.online/v1/usage/analytics' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 0 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "period": "rolling",
  "period_days": 30,
  "period_start": "2026-08-08T00:52:10",
  "period_end": "2026-09-07T00:52:10",
  "credits_limit": 20000,
  "credits_used_this_period": 1240,
  "credits_remaining": 18760,
  "total_calls": 1102,
  "total_credits": 1240,
  "by_endpoint": [
    {
      "endpoint": "/v1/racing/next-to-go",
      "calls": 611,
      "credits": 611
    },
    {
      "endpoint": "/v1/racing/best-odds",
      "calls": 302,
      "credits": 302
    },
    {
      "endpoint": "/v1/racing/price-history",
      "calls": 108,
      "credits": 216
    },
    {
      "endpoint": "/v1/racing/results",
      "calls": 81,
      "credits": 81
    }
  ]
}

Related endpoints

• GET /v1/account — Your account: email, plan, password, billing and consent status
• POST /v1/account/marketing — Turn promotional emails on or off for your account
• POST /v1/account/password — Set or change your account password
• GET /v1/billing/overage — Overage: state, rate and ceiling
• POST /v1/billing/overage — Switch overage on or off
• GET /v1/billing/portal — Self-service billing portal link
• POST /v1/billing/portal — Billing portal link (console; confirms your password)
• GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page