> ## Documentation Index
> Fetch the complete documentation index at: https://docs.v3code.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Token wallet

> How hosted usage is tracked on your account.

The token wallet is V3Code's usage meter. It shows what you've used and what it cost, broken down by model, so there are no surprises — whether you're on BYOK or a hosted plan.

## What it tracks

* **Spend over time** — this session, today, last 7 days, last 30 days, with a tokens-per-day chart.
* **Requests and models used** — how many calls, across how many models.
* **Per-model breakdown** — your top models by tokens and cost (e.g. Sonnet, Haiku, Opus), expandable to the full list.
* **Cache reads saved** — how many input tokens caching saved you. This is a headline number, because caching is where the savings come from (see [Models overview](/models/overview)).

BYOK token usage is **tracked locally and persists across restarts**, and cost is shown as a **cache-aware estimate** — it accounts for cached input rather than charging you full price for tokens the cache served.

## Soft budget

You can set a **soft budget** — a spend cap across all models over a period. It's a guardrail and a signal, shown as a fill bar in the meter — not a hard cutoff.

## How paid quota is metered

On a paid plan your included usage is split into buckets, each with its own meter for the cycle:

| Bucket                | Covers                                            |
| --------------------- | ------------------------------------------------- |
| **V3 Pro / V3 Fast**  | Fast-tier DeepSeek requests included in your plan |
| **Auto / Hybrid**     | Auto-routed and hybrid-model usage                |
| **Opus**              | Premium Opus-class usage                          |
| **On-demand overage** | Usage beyond included limits, billed in arrears   |