GET /analytics/summary — Current Month Spend Summary

Returns the current-month total spend in USD, budget utilization percentage, and a per-model cost breakdown for your Tokonomics account.

The summary endpoint gives you a real-time snapshot of your AI spend for the current calendar month. You get the total spend in USD, how much of your configured monthly budget you’ve consumed, and a per-model breakdown so you can see exactly which models are driving your costs.

Endpoint

GET https://tokonomics.ca/analytics/summary

Authentication

This endpoint requires a valid Bearer token in the Authorization header.

Authorization: Bearer mk_your_key

Response Fields

current_month_spend · number

Your total AI spend for the current calendar month in USD. Example: 127.45

monthly_budget · number

The monthly budget cap configured for your account in USD. Requests are blocked with a 429 once this limit is reached. Example: 500.00

budget_used_percent · number

The percentage of your monthly budget already consumed. Calculated as (current_month_spend / monthly_budget) * 100. Example: 25.49

by_model · array

A breakdown of spend and request count per model for the current month.

Show by_model fields

model · string

The model name. Example: "gpt-4o"

spend · number

Total spend for this model in USD for the current month. Example: 89.20

requests · integer

Total number of requests made to this model in the current month. Example: 4520

Example

Request

curl "https://tokonomics.ca/analytics/summary" \
  -H "Authorization: Bearer mk_your_key"

{
  "current_month_spend": 127.45,
  "monthly_budget": 500.00,
  "budget_used_percent": 25.49,
  "by_model": [
    {"model": "gpt-4o", "spend": 89.20, "requests": 4520},
    {"model": "claude-opus-4-5", "spend": 38.25, "requests": 1100}
  ]
}