---
title: "CLI — Wallet & billing"
description: "Metalhost CLI commands for wallet balance, top-ups, usage, invoices, and auto-recharge."
url: "https://metalhost.net/docs/developers/guides/cli-wallet"
---

# CLI — Wallet & billing

`metalhost wallet` (alias `billing`) manages org wallets, top-ups, usage, and invoices.

## Balance & rates

| Command | What it does |
| --- | --- |
| `wallet balance WALLET` | Available + held balance. |
| `wallet rates` | Public meter rates. |
| `wallet forecast --billing-account NAME` | MTD spend + forecast. |

## Top-ups

| Command | What it does |
| --- | --- |
| `wallet top-up stripe --wallet ... --amount-minor ...` | Stripe PaymentIntent. |
| `wallet top-up coinbase --wallet ... --amount-minor ...` | Coinbase USDC checkout. |
| `wallet payment-method setup-intent ...` | Add a card. |
| `wallet payment-method list ...` | List saved cards. |

## Auto-recharge & alerts

| Command | What it does |
| --- | --- |
| `wallet auto-recharge configure WALLET ...` | Threshold + amount. |
| `wallet alerts configure WALLET ...` | Balance / days-remaining alerts. |

## Usage & invoices

| Command | What it does |
| --- | --- |
| `wallet usage query ...` | Bucketed usage. |
| `wallet usage export ...` | CSV/NDJSON export URL. |
| `wallet invoice list --billing-account NAME` | List invoices. |
| `wallet invoice pdf NAME` | Presigned PDF URL. |

## What's next

- [Dashboard → Wallet & top-ups](https://metalhost.net/docs/dashboard/guides/wallet-topup.md)
- [Go SDK — Wallet](https://metalhost.net/docs/developers/guides/sdk-wallet.md)