Token usage and cost

The Tokens screen shows input and output usage over the selected date range. Use the agent, app, and model breakdowns to locate the source of a change. Cost is an estimate based on reported usage and the model pricing available to ACP, not a provider invoice.

Usage API

Method and route Purpose
GET /api/tokens/analytics?days=30 Aggregate analytics for the organization.
GET /api/tokens/agent/:id?days=30 Daily usage for one agent.

The API accepts the days parameter. Grouping is presented by the UI using the returned breakdowns; a group query is not required. Check the model identifier and token counts if cost is missing or unexpected. Model providers bill separately from ACP preview access.