drift Docs
Pages
drift Docs
Start
What is Drift?
The tour, if you are new here.
Use cases
Whether Drift does your thing.
Getting started
Nothing to deployed, in one command.
Architecture
How a slice is put together.
What it costs
The free grant, four unit prices, two rules.
Moving off Azure
Estimate, snapshot and transform a resource group.
Build
Canvas
Static sites, same origin as your API.
Tools
Operate
Auth
Route gates, API keys and your account.
Teams
More than one person on one account.
Security
Boundaries, sandboxing and hardening.
Troubleshooting
Error codes
What went wrong, and what to do about it.
Legal
Acceptable use
What a slice may not be used for.
Data processing
The DPA, and every sub-processor.

drift wallet

Your account holds a balance in euros: money you have paid in and not yet spent. Nothing is taken from it except for a price shown to you first. These commands read the balance, list what moved it, and add to it.

Command Description
drift wallet balancePrint your balance in euros
drift wallet historyList what moved your balance, newest first
drift wallet topup <euros>Start a top-up and print where to pay

Every command acts on the account you are signed in as. None of them takes an account name. The platform owns the ledger and every decision about money; the CLI asks and prints the answer, and holds no copy of a minimum or a price.

Each command takes --json, which prints the platform's reply as it came, for scripts.

During the closed alpha the payment provider is a stand-in.

A top-up confirms at once and no real money moves. Billing starts later: nothing is taken from the balance for a slice yet, so the history lists top-ups only.

Reading the balance

Shell
$ drift wallet balance
€7.59

A balance of nothing prints €0.00. The balance is shown in euros and cents. It is kept as whole cents, so it never carries a rounding error.

Reading the history

Shell
$ drift wallet history --limit 2
WHEN                 WHAT          AMOUNT   BALANCE  FOR
2026-11-03 10:00:00  slice period  -€2.41   €7.59    slice-a
2026-11-02 10:00:00  top-up        +€10.00  €10.00   mock_000001

older: drift wallet history --before 2

Each line is one movement of money. Money in is marked +, money out -, and BALANCE is what you held right after that line. WHEN is in your local time. FOR is what the movement was about: the payment of a top-up, or the slice a charge was for; it is - where there is none. A new account prints Nothing has moved your balance yet.

What Meaning
top-upYou paid money in
credit grantedDrift added money to your balance

The CLI also has names for slice period, renewal, resize and refund. Billing starts later, so none of them is written yet. A kind this version of the CLI does not know is printed as the platform named it.

Flag Description
--limit <n>Entries per page, from 1 to 200. The default is 20.
--before <n>Only entries older than entry number n.

A full page ends with the command that asks for the next one, with the number filled in. A page shorter than the limit is the last. Asking for entries older than the oldest prints No older entries.

Topping up

Shell
$ drift wallet topup 12.50

Starts a top-up of the amount you give and prints where to pay. The balance moves when the payment is confirmed, not when you run the command.

An amount is euros with at most two decimals. 10, 10.5, 10.50, €10 and 10,50 are all accepted. An amount with a third decimal, such as 10.505, is refused rather than rounded, and zero, a negative amount or anything that is not a number is refused before anything is sent.

What the command prints depends on what the payment is when the platform answers:

Status What you see
paidTopped up €10.00 (payment mock_000001). followed by Your balance is €10.00.
pendingStarted a top-up of €12.50 (payment <id>). Your balance moves when it is paid. and a Pay at: address
anything elseThe top-up of €12.50 (payment <id>) is <status>. Nothing was added to your balance.

Only a paid top-up says the money arrived. A pending one never claims a balance.

The smallest top-up is the platform's to say. A top-up below it is refused, and the refusal states the minimum:

Shell
$ drift wallet topup 1
Couldn't start a top-up: wallet: that amount cannot be topped up: 100 cents, the minimum is 500.