Usage
Track Credits balance, recent consumption, and daily token usage at /account/usage.
Find it at: /account/usage.
1. Credits balance breakdown
The Credit Balance section breaks your total Credits into the three sub-types, with per-bucket expiration where applicable.
| Sub-type | Source | Expiration | Bucket field on backend |
|---|---|---|---|
| Monthly Credits | Subscription tier (Free / Base / Pro / Elite) | Refresh on each billing cycle; lost if unused | subscription |
| Recharge Credits | Custom Credits top-up at /top-up-credits | Roll over indefinitely | addon |
| Limited-time Credits | Promo / referral / survey rewards | Expire on a fixed date | event |
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:
| Window | Granularity |
|---|---|
| 7d | Last 7 days, daily bars |
| 30d | Last 30 days, daily bars |
| 90d | Last 90 days, daily bars |
Each bar stacks four series:
subscription— Monthly Credits consumedaddon— Recharge Credits consumedevent— Limited-time Credits consumedfree— 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
addonseries will start counting once you spend from this bucket.
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.