> ## Documentation Index > Fetch the complete documentation index at: https://docs.moneda.com/llms.txt > Use this file to discover all available pages before exploring further. # Command Reference > Complete reference of all CLI commands All Moneda CLI commands follow the pattern `moneda [options]`. Use `moneda --help` to see available commands in any group. Manage your CLI session. | Command | Description | | -------------------- | --------------------------------------------------------- | | `moneda auth login` | Open browser to authenticate with OAuth | | `moneda auth logout` | Clear stored credentials | | `moneda auth status` | Show current session info (username, email, token expiry) | View your account details and settings. | Command | Description | | --------------------------------- | --------------------------------------------------------------------------- | | `moneda account show` | List registered external wallets and bank accounts | | `moneda account balance` | Show balances for USD and EUR accounts | | `moneda account lifetime-savings` | Show your lifetime savings from using Moneda (covered fees + plan discount) | | `moneda account wallet` | Display your smart wallet address on Base | | `moneda account settings` | View app preferences and notification settings | | `moneda account virtual-accounts` | Show IBAN and ACH virtual account details | Browse, categorize, and export your transactions. | Command | Description | | ------------------------------------------------------------------------------------- | ---------------------------------------------------- | | `moneda transaction list [--limit N] [--currency USD\|EUR] [--from DATE] [--to DATE]` | List transactions with optional filters | | `moneda transaction show ` | Show a single transaction by hash | | `moneda transaction categorize ` | Assign a spending category to a transaction | | `moneda transaction note ` | Add or update a note on a transaction | | `moneda transaction batch-categorize [-f FILE \| --updates JSON]` | Categorize up to 25 transactions in one request | | `moneda transaction batch-note [-f FILE \| --updates JSON]` | Attach notes to up to 25 transactions in one request | | `moneda transaction export [--year YYYY] [--format csv\|json]` | Export transactions for a given period | Manage your Moneda and external contacts. | Command | Description | | ------------------------------- | ------------------------------------------------ | | `moneda contact list` | List all saved contacts | | `moneda contact add ` | Add a Moneda user to your contacts | | `moneda contact search ` | Search for Moneda users by name, email, or phone | Send money and check payment status. | Command | Description | | ------------------------------------------------------------------------- | -------------------------------------------------------- | | `moneda payment send --to --amount --currency ` | Initiate a payment (requires approval in the Moneda app) | | `moneda payment status ` | Check the status of a pending payment | Payments initiated via the CLI always require confirmation in the Moneda mobile app before they are executed. Check your points balance and activity. | Command | Description | | ------------------------------------ | ------------------------------------------ | | `moneda points balance` | Show your current points balance | | `moneda points activity [--limit N]` | View points earning and redemption history | Manage your referral program. | Command | Description | | ---------------------- | --------------------------------------------- | | `moneda referral code` | Display your unique referral link | | `moneda referral list` | Show friends you've referred and their status | Search the Moneda knowledge base. | Command | Description | | --------------------------------- | ------------------------ | | `moneda knowledge search ` | Search FAQs about Moneda | Manage saved bank accounts. | Command | Description | | -------------------------------------------------------------------------------- | ----------------------------- | | `moneda bank list` | List your saved bank accounts | | `moneda bank add --type [--iban IBAN] [--routing NUM --account NUM]` | Save a new bank account | Manage saved external wallets. | Command | Description | | -------------------------------------------- | -------------------------------- | | `moneda wallet list` | List your saved external wallets | | `moneda wallet add
[--label NAME]` | Save an external crypto wallet | Read-only access to your sub-accounts (nested Safe smart accounts). | Command | Description | | ----------------------------------------------------------------------------- | ----------------------------------------------------------- | | `moneda sub-account list [--include-closed]` | List your sub-accounts | | `moneda sub-account get --id ` | Show full detail for one sub-account | | `moneda sub-account balance --id [--currency USDC\|EURC\|CHFAU\|CADD]` | Read on-chain balances for a sub-account | | `moneda sub-account wealth` | Aggregate wealth across the main account + every live vault | | `moneda wealth` | Top-level alias for `sub-account wealth` | `moneda vault` is an alias for `moneda sub-account`. Mutations (create / top-up / withdraw / freeze / close) require a passkey-signed UserOp from the Moneda mobile app and are not exposed via the CLI. Read-only access to social recovery contacts and ZK email-based recovery. | Command | Description | | ------------------------------------------------- | --------------------------------------------------------------------- | | `moneda recovery contacts` | List your recovery contacts and people who have you as their guardian | | `moneda recovery emails-list [--account-id UUID]` | List email addresses set up for ZK email-based recovery | | `moneda recovery emails-get --id ` | Get full detail for one recovery email | | `moneda recovery config [--account-id UUID]` | Show accepted recovery emails, total weight, and threshold | | `moneda recovery status [--account-id UUID]` | Latest recovery request snapshot — is a recovery in flight? | Recovery initiation, guardian invitation, and recovery execution are passkey-signed flows that live in the mobile app. Current rate quotes. | Command | Description | | -------------------------------------------------- | --------------------------------------------------------- | | `moneda rates apy [--currency USD\|EUR\|CHF\|CAD]` | Annual percentage yield (APY) rates for earnings products | | `moneda rates exchange [--from CCY] [--to CCY]` | Pairwise FX rate between supported currencies | Spending breakdowns over a time period. | Command | Description | | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | | `moneda spending summary [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF\|CAD]` | Spending totals by transaction type group | | `moneda spending by-category [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF\|CAD]` | Spending grouped by user-assigned category | | `moneda spending by-contact --account-id [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF\|CAD]` | Total sent to a single recipient | | `moneda spending by-merchant [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF\|CAD]` | Spending grouped by recipient/merchant | | `moneda spending comparison --current-from DATE --current-to DATE --previous-from DATE --previous-to DATE [--currency USD\|EUR\|CHF\|CAD]` | Compare spending across two arbitrary windows | | `moneda spending daily --currency USDC\|EURC\|CHFAU\|CADD [--window 1d\|1w\|1m\|1y \| --from DATE --to DATE]` | Daily series of spending totals for a stablecoin | | `moneda spending transactions [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF\|CAD] [--category CAT] [--account-id UUID]` | Drill into the underlying transactions for a window or bucket | Read-only access to in-app notifications. | Command | Description | | ----------------------------------------------------------------------------- | --------------------------------------- | | `moneda notification list [--filter all\|unread] [--limit N] [--cursor UUID]` | List in-app notifications, newest first | | `moneda notification unread-count` | Number of unread notifications | Mark-as-read / dismiss / clear-all are tied to the active mobile push session and stay in the app — they're not exposed via the CLI. Browse, search, upload, and manage transaction receipts and their parsed line items. | Command | Description | | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | `moneda receipt list [--transaction-hash HASH] [--status STATUS] [--needs-review] [--limit N]` | List receipts, newest first | | `moneda receipt get --id ` | Show full extracted detail + presigned download URL for one receipt | | `moneda receipt line-items --receipt-id ` | List the parsed line items on a receipt | | `moneda receipt search --query [--category CAT] [--start-date DATE] [--end-date DATE]` | Search across every line item you've uploaded; aggregates spend by currency | | `moneda receipt upload ` | Three-step presigned upload (request → PUT → finalize), runs OCR + matching | | `moneda receipt import-url ` | Import a receipt directly from a URL (SSRF-guarded) | | `moneda receipt download --id [-o file]` | Fetch the presigned URL and write bytes to disk | | `moneda receipt attach --id --transaction-hash HASH` | Link a receipt to a transaction | | `moneda receipt detach --id ` | Unlink a receipt from its transaction | | `moneda receipt confirm-suggestion --id ` | Accept the OCR auto-match suggestion | | `moneda receipt reject-suggestion --id ` | Reject the OCR auto-match suggestion | | `moneda receipt add-line-item --id --description … --total …` | Insert a line item (after manual review) | | `moneda receipt update-line-item --line-item-id …` | Modify a line item | | `moneda receipt delete-line-item --line-item-id ` | Remove a line item | | `moneda receipt delete --id ` | Delete the receipt and its line items | Read-only access to the accounts-payable queue. Bills are the invoice-shaped sibling of receipts; paying / uploading / linking is handled in the mobile app. | Command | Description | | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `moneda bill list [--status STATUS] [--cursor TOKEN]` | List bills, due-soon first | | `moneda bill get --id ` | Show full extracted detail for one bill (merchant, IBAN/BIC, due date, presigned download URL) | | `moneda bill download --id [-o file]` | Fetch the underlying PDF/XML via presigned URL | Read your balance-pay subscription charge history and generate ZUGFeRD plan invoices (PDF/A-3 with embedded EN 16931 XML). The invoice generator is idempotent — the first call renders + uploads, subsequent calls return a fresh 1h presigned download URL. | Command | Description | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `moneda subscription list [--limit N] [--cursor TOKEN]` | List your subscription charges, newest first (plan, period, amount, status, on-chain hash, invoice number) | | `moneda subscription invoice ` | Generate (idempotently) the ZUGFeRD invoice for a charge and return a 1h presigned download URL | Read PCI-redacted card metadata and freeze/unfreeze cards on-chain. Destructive operations (suspend, terminate, replace, change PIN, reveal PIN) are mobile-app-only and require a fresh passkey assertion. | Command | Description | | ---------------------------------- | ------------------------------------------------------------------------------------- | | `moneda card list` | List your cards (status, last four digits, expiry, design) | | `moneda card get --id ` | Show PCI-redacted details for one card | | `moneda card freeze --id ` | Freeze a card on-chain via `PausableCardGuard` (reversible, no Monavate-state change) | | `moneda card unfreeze --id ` | Unfreeze a card on-chain (idempotent, reverses `freeze`) | `freeze` and `unfreeze` require the `write:cards` scope, which is **not** granted by default — pass `--api-key` from a key with that scope, or sign in with a session that requested it. Beyond `moneda payment send` / `status` (above), the `payment` group exposes route discovery and quoting: | Command | Description | | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | `moneda payment destinations [--country-symbol XX]` | List country/currency/rail combinations Moneda can pay out to, with the required fields per route | | `moneda payment quote --from-currency XXX --to-currency YYY [--amount-in N \| --amount-out N]` | Preview cost, FX rate, and final amount before calling `send` | Read access plus pause/resume for scheduled (recurring) transactions. Create / activate / cancel / edit / renew are NOT exposed — they need the user's passkey signature on a Smart Sessions install UserOp, which is mobile-app only. | Command | Description | | -------------------------------------------- | ------------------------------------------------------------- | | `moneda scheduled-tx list [--status STATUS]` | List scheduled transactions | | `moneda scheduled-tx get --id ` | Show full detail for one schedule | | `moneda scheduled-tx history --id ` | List past executions for one schedule | | `moneda scheduled-tx upcoming [--limit N]` | List the next scheduled executions across all your schedules | | `moneda scheduled-tx pause --id ` | Pause execution (backend-only state flip; safe to do via CLI) | | `moneda scheduled-tx resume --id ` | Resume execution | Read access plus pause/resume/revoke for scoped autonomous agent sessions. Create / execute and the passkey-bound install are not exposed via the CLI. Both scopes (`read:agent_sessions`, `write:agent_sessions`) are opt-in. | Command | Description | | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | `moneda agent-session create --recipient 0x… --currency USD --max-amount-per-execution 25.00 --max-amount-per-period 100.00 --period-seconds 86400` | Create a session (returns an activation link the user opens in the app) | | `moneda agent-session execute --id --recipient 0x… --amount 10.00 --currency USD [--idempotency-key KEY]` | Execute a payment within the session's policy | | `moneda agent-session list [--status STATUS]` | List your agent sessions with status and remaining period cap | | `moneda agent-session get --id ` | Show one session with its 5 most recent executions | | `moneda agent-session pause --id ` | Pause an active session (backend-only flip; halts execution) | | `moneda agent-session resume --id ` | Resume a manually-paused session | | `moneda agent-session revoke --id ` | Revoke a session — permanently halts all execution | Redeem a completed top-up payment to Moneda for prepaid AI usage credits, and manage your monthly spend limit. The purchase amount is read from the confirmed payment and granted once (idempotent on the hash). The `write:usage_credits` scope is opt-in. | Command | Description | | ------------------------------------------------- | ----------------------------------------------------------------------- | | `moneda usage-credits purchase ` | Redeem a completed credit-purchase payment for prepaid AI usage credits | | `moneda usage-credits set-limit ` | Set the monthly spend cap (USD), or `unlimited` to remove it | Manage CLI settings. | Command | Description | | --------------------------------- | ------------------------------------------------------- | | `moneda config set ` | Set a configuration value (e.g., default output format) | | `moneda config get ` | Get a configuration value | | `moneda config list` | Show all configuration settings | Make raw HTTP requests to the Moneda REST API. | Command | Description | | ------------------------------------------ | ------------------------------------------- | | `moneda api [--data JSON]` | Send a raw API request with your auth token | This is useful for accessing endpoints that don't have a dedicated CLI command, or for scripting and debugging. ```bash theme={null} moneda api GET /v1/balances moneda api PATCH /v1/profile --data '{"displayName": "Alice"}' ``` ## What's next? See common workflows and scripting patterns. Set up and manage your CLI credentials. See the full REST API endpoint reference. Understand which permissions each command uses.