Command Reference - Moneda Docs

auth — Authentication

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)

account — Account Information

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 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

transaction — Transactions

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 <hash>`	Show a single transaction by hash
`moneda transaction categorize <id> <category>`	Assign a spending category to a transaction
`moneda transaction note <id> <text>`	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

contact — Contacts

Manage your Moneda and external contacts.

Command	Description
`moneda contact list`	List all saved contacts
`moneda contact add <username>`	Add a Moneda user to your contacts
`moneda contact search <query>`	Search for Moneda users by name, email, or phone

payment — Payments

Send money and check payment status.

Command	Description
`moneda payment send --to <recipient> --amount <N> --currency <USD\|EUR>`	Initiate a payment (requires approval in the Moneda app)
`moneda payment status <id>`	Check the status of a pending payment

Payments initiated via the CLI always require confirmation in the Moneda mobile app before they are executed.

points — Points & Rewards

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

referral — Referrals

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

knowledge — FAQ & Help

Search the Moneda knowledge base.

Command	Description
`moneda knowledge search <query>`	Search FAQs about Moneda

bank — Bank Accounts

Manage saved bank accounts.

Command	Description
`moneda bank list`	List your saved bank accounts
`moneda bank add --type <iban\|ach> [--iban IBAN] [--routing NUM --account NUM]`	Save a new bank account

wallet — External Wallets

Manage saved external wallets.

Command	Description
`moneda wallet list`	List your saved external wallets
`moneda wallet add <address> [--label NAME]`	Save an external crypto wallet

sub-account / vault — Sub-accounts (Vaults)

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 <UUID>`	Show full detail for one sub-account
`moneda sub-account balance --id <UUID> [--currency USDC\|EURC\|CHFAU]`	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.

recovery — Account Recovery

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 <UUID>`	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.

rates — Rate Quotes

Current rate quotes.

Command	Description
`moneda rates apy [--currency USD\|EUR\|CHF]`	Annual percentage yield (APY) rates for earnings products
`moneda rates exchange [--from CCY] [--to CCY]`	Pairwise FX rate between supported currencies

spending — Spending Breakdown

Spending breakdowns over a time period.

Command	Description
`moneda spending summary [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF]`	Spending totals by transaction type group
`moneda spending by-category [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF]`	Spending grouped by user-assigned category
`moneda spending by-contact --account-id <UUID> [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF]`	Total sent to a single recipient
`moneda spending by-merchant [--period 7d\|30d\|90d] [--currency USD\|EUR\|CHF]`	Spending grouped by recipient/merchant
`moneda spending comparison --current-from DATE --current-to DATE --previous-from DATE --previous-to DATE [--currency USD\|EUR\|CHF]`	Compare spending across two arbitrary windows
`moneda spending daily --currency USDC\|EURC\|CHFAU [--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] [--category CAT] [--account-id UUID]`	Drill into the underlying transactions for a window or bucket

notification / notifications — In-app Inbox

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.

receipt / receipts — Receipts & line items

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 <UUID>`	Show full extracted detail + presigned download URL for one receipt
`moneda receipt line-items --receipt-id <UUID>`	List the parsed line items on a receipt
`moneda receipt search --query <text> [--category CAT] [--start-date DATE] [--end-date DATE]`	Search across every line item you’ve uploaded; aggregates spend by currency
`moneda receipt upload <file>`	Three-step presigned upload (request → PUT → finalize), runs OCR + matching
`moneda receipt import-url <https://…>`	Import a receipt directly from a URL (SSRF-guarded)
`moneda receipt download --id <UUID> [-o file]`	Fetch the presigned URL and write bytes to disk
`moneda receipt attach --id <UUID> --transaction-hash HASH`	Link a receipt to a transaction
`moneda receipt detach --id <UUID>`	Unlink a receipt from its transaction
`moneda receipt confirm-suggestion --id <UUID>`	Accept the OCR auto-match suggestion
`moneda receipt reject-suggestion --id <UUID>`	Reject the OCR auto-match suggestion
`moneda receipt add-line-item --id <UUID> --description … --total …`	Insert a line item (after manual review)
`moneda receipt update-line-item --line-item-id <UUID> …`	Modify a line item
`moneda receipt delete-line-item --line-item-id <UUID>`	Remove a line item
`moneda receipt delete --id <UUID>`	Delete the receipt and its line items

bill / bills — AP queue

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 <UUID>`	Show full extracted detail for one bill (merchant, IBAN/BIC, due date, presigned download URL)
`moneda bill download --id <UUID> [-o file]`	Fetch the underlying PDF/XML via presigned URL

card / cards — Cards

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 <UUID>`	Show PCI-redacted details for one card
`moneda card freeze --id <UUID>`	Freeze a card on-chain via `PausableCardGuard` (reversible, no Monavate-state change)
`moneda card unfreeze --id <UUID>`	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.

payment — Payments (extended)

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`

scheduled-tx / recurring — Scheduled (recurring) transactions

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 <UUID>`	Show full detail for one schedule
`moneda scheduled-tx history --id <UUID>`	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 <UUID>`	Pause execution (backend-only state flip; safe to do via CLI)
`moneda scheduled-tx resume --id <UUID>`	Resume execution

config — Configuration

Manage CLI settings.

Command	Description
`moneda config set <key> <value>`	Set a configuration value (e.g., default output format)
`moneda config get <key>`	Get a configuration value
`moneda config list`	Show all configuration settings

api — Raw API Calls

Make raw HTTP requests to the Moneda REST API.

Command	Description
`moneda api <method> <path> [--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.

moneda api GET /v1/balances
moneda api PATCH /v1/profile --data '{"displayName": "Alice"}'

CLI Examples

See common workflows and scripting patterns.

CLI Authentication

Set up and manage your CLI credentials.

API Endpoints

See the full REST API endpoint reference.

Scopes

Understand which permissions each command uses.

CLI

Documentation Index

​What’s next?

CLI Examples

CLI Authentication

API Endpoints

Scopes

What’s next?