Command Reference

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, EUR, CHF, CAD and MXN 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
`moneda account virtual-account-limits`	Show remaining deposit/withdrawal limit and verification status
`moneda account settlement-estimate`	Show when a US bank (ACH) transfer would settle

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

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.

dinari — Tokenized Equities

Read-only checks on your tokenized-equity (dShares) brokerage status.

Command	Description
`moneda dinari capabilities`	Jurisdiction, whether you can trade, and the ordered reasons why not
`moneda dinari us-requirements`	What a US-jurisdiction user still owes before their brokerage account can open
`moneda dinari market-status`	Whether the US market is open, which session is running, and when it next changes
`moneda dinari free-trade-allowance`	Commission-free trades left in the current window, and when it resets

There are no write commands here on purpose. Brokerage disclosures and personal attestations are accepted by you in the Moneda app, having seen the actual document — never relayed through a CLI session, API key, or agent.

passkey — Passkeys

List your passkeys and rename them.

Command	Description
`moneda passkey list [--target WALLET\|LOGIN]`	List your passkeys. `WALLET` (default) shows the wallet signing keys with `kind` (primary / backup) and `onchainStatus`; `LOGIN` shows the email-login credentials with a masked credential id. Add `--detail` for every field
`moneda passkey label --id <UUID> --label "Work laptop" [--target WALLET\|LOGIN]`	Rename a passkey. Empty label clears it back to the provider name

Registering, replacing, or removing a passkey needs a WebAuthn ceremony on the device, so those flows live in the mobile app. The label is cosmetic and carries no security weight.

rates — Rate Quotes

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 — Spending Breakdown

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

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

subscription — billing history & invoices

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 <chargeId>`	Generate (idempotently) the ZUGFeRD invoice for a charge and return a 1h presigned download 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 (any window that elapsed while paused is skipped, never run retroactively)

agent-session / agent-sessions — Scoped autonomous agent sessions

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 <UUID> --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 <UUID>`	Show one session with its 5 most recent executions
`moneda agent-session pause --id <UUID>`	Pause an active session (backend-only flip; halts execution)
`moneda agent-session resume --id <UUID>`	Resume a manually-paused session
`moneda agent-session revoke --id <UUID>`	Revoke a session — permanently halts all execution

List the devices and clients signed in to your account plus your connected agents, and sign other devices out. read:sessions is a default scope; the terminate commands need the opt-in write:sessions scope.

Command	Description
`moneda session list`	List your active login sessions and connected agents, with location and last-active time
`moneda session terminate --id <UUID>`	Terminate one login session — the device is signed out immediately
`moneda session terminate-all`	Terminate all your login sessions on other devices, keeping the current one

usage-credits — AI usage credits

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 <transactionHash>`	Redeem a completed credit-purchase payment for prepaid AI usage credits
`moneda usage-credits set-limit <amount>`	Set the monthly spend cap (USD), or `unlimited` to remove it

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

What’s next?

CLI Examples

CLI Authentication

API Endpoints

Scopes

​What’s next?

CLI Examples

CLI Authentication

API Endpoints

Scopes

What’s next?