Skip to main content

Usage

Track Credits balance, recent consumption, and daily token usage at /account/usage.

Find it at: /account/usage.

Usage page


1. Credits balance breakdown

The Credit Balance section breaks your total Credits into the three sub-types, with per-bucket expiration where applicable.

Sub-typeSourceExpirationBucket field on backend
Monthly CreditsSubscription tier (Free / Base / Pro / Elite)Refresh on each billing cycle; lost if unusedsubscription
Recharge CreditsCustom Credits top-up at /top-up-creditsRoll over indefinitelyaddon
Limited-time CreditsPromo / referral / survey rewardsExpire on a fixed dateevent

Each Recharge or Limited-time bucket is tracked individually — buying $20 today and $50 next week produces two Recharge buckets, each with its own credit-in timestamp. The page lists all currently active buckets so you can see exactly which ones will expire and when.


2. Ledger

The Ledger pane lists every Credits movement on your account, both debits (spend) and credits (grant / top-up).

Each row shows:

  • Timestamp — when the entry was recorded.
  • Action — what triggered it (e.g. AI chat turn, Agentic Trading step, Custom Credits purchase, promo grant, refund reversal).
  • Amount — signed integer, positive for credit-in, negative for spend.
  • Bucket — which bucket the change applied to (subscription, addon, event).

The ledger is paginated monthly. Use the date filter to jump to a specific month.


3. Daily token usage

The Daily Token Usage chart shows your Credits consumption broken down by bucket over time. Three time windows are available:

WindowGranularity
7dLast 7 days, daily bars
30dLast 30 days, daily bars
90dLast 90 days, daily bars

Each bar stacks four series:

  • subscription — Monthly Credits consumed
  • addon — Recharge Credits consumed
  • event — Limited-time Credits consumed
  • free — Free-tier baseline consumed (where applicable)

The window header also surfaces two totals:

  • Total Credits used — sum across all buckets for the selected window.
  • Agent steps — number of metered Alphio AI operations in the window.

4. Reading the deduction order

When you spend Credits, Alphio deducts from your buckets in a deterministic order:

Limited-time → Monthly → Recharge

The intent is simple — burn the expiring stuff first, then your regular monthly grant, and keep Recharge (which never expires) as your reserve.

Practical implications:

  • If you have a promo grant ending Sunday, it gets spent before your Monthly Credits.
  • Your Monthly Credits get spent before any Custom Credits you bought.
  • Recharge Credits only get drawn down once both Limited-time and Monthly are exhausted.

The Ledger's bucket column tells you which bucket each spend came out of.


5. Topping up

When you run low, head to /top-up-credits to buy more Recharge Credits. See the dedicated deep-dive: /account/custom-credits.

After a top-up:

  • The new Recharge bucket appears in section 1 within seconds of PSP webhook confirmation.
  • The Ledger gets a new credit-in entry (section 2).
  • The Daily Token Usage chart's addon series will start counting once you spend from this bucket.

Credits ledger


Agent Instructions: Querying This Documentation

If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:

GET https://docs.alphio.ai/account/usage.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.