Command Reference

auth — Authentication

Manage your CLI session.

Command	Description
`moneda auth login`	Open browser to authenticate with OAuth
`moneda auth signup`	Create a Moneda account from the terminal
`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, verification status and whether an information request is waiting (`rfiRequired`)
`moneda account information-requests`	List compliance information requests from Iron/MoonPay (answer them in the app)
`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\|CHF\|CAD\|MXN] [--start-date DATE] [--end-date 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] [--currency USD\|EUR\|CHF\|CAD\|MXN]`	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 "<text>"`	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\|CHF\|CAD> [--from main\|earnings\|sub-account:<UUID>]`	Initiate a payment (requires approval in the Moneda app). `--from sub-account:` also needs `write:sub_accounts`
`moneda payment exchange --from <CUR> --to <CUR> --amount <N>`	Exchange money between your own currency accounts (requires approval in the Moneda app)
`moneda payment crypto-trade --symbol <ASSET> --side <BUY\|SELL> --currency <CUR> --amount <N>`	Buy or sell a crypto asset with your own balance (requires approval in the Moneda app)
`moneda payment token-buy --token <ADDRESS> --currency <USD\|EUR\|CHF\|MXN> --amount <N>`	Buy a Base token by contract address with your own balance (requires approval in the Moneda app)
`moneda payment earnings-move --direction <DEPOSIT\|WITHDRAW> --vault <MORPHO\|YO> --currency <USD\|EUR\|MXN> --amount <N>`	Deposit into or withdraw from an earnings vault (requires approval in the Moneda app)
`moneda payment status --payment-id <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 redemption-config`	Show the points-to-credits rate, minimum and monthly cap
`moneda points redeem <points>`	Redeem points for AI usage credits
`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 "<text>"`	Search FAQs about Moneda
`moneda knowledge categories`	List FAQ categories with each question and its id
`moneda knowledge category --slug <slug>`	List the FAQ items in a category
`moneda knowledge item --id <id>`	Show one FAQ answer with related items

bank — Bank Accounts

Manage saved bank accounts.

Command	Description
`moneda bank list`	List your saved bank accounts
`moneda bank add --first-name NAME --last-name NAME --country CC [--iban IBAN] [--routing NUM --account NUM] [--account-type CHECKING\|SAVINGS] [--confirmed]`	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> --name NAME [--confirmed]`	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\|MXNB]`	Read on-chain balances for a sub-account
`moneda sub-account wealth`	Aggregate wealth across the main account + every live vault
`moneda sub-account proposals --sub-account-id <UUID> [--include-resolved]`	List the approval requests on a joint account, with approval counts
`moneda sub-account proposal --proposal-id <UUID>`	Show one joint-account request with each member’s approval
`moneda wealth`	Top-level alias for `sub-account wealth`

moneda vault is an alias for moneda sub-account.These commands only propose: each creates a request you approve (and sign, when money moves) in the Moneda app. They need the write:sub_accounts scope.

Command	Description
`moneda sub-account top-up --id <UUID> --amount <N> --currency <USD\|EUR\|CHF\|CAD\|MXN>`	Propose moving money from your main account into a sub-account
`moneda sub-account withdraw --id <UUID> --amount <N> --currency <CUR>`	Propose moving money from a sub-account back to your main account
`moneda sub-account swap --id <UUID> --from-asset <ASSET> --to-asset <ASSET> --amount <N> [--slippage-bps <0-200>]`	Propose a swap inside a sub-account
`moneda sub-account freeze --id <UUID>`	Propose freezing a sub-account you created
`moneda sub-account propose --id <UUID> --proposal-type <SPEND\|WITHDRAW> --amount <N> --currency <CUR> [--recipient-username <USER>] [--description <TEXT>]`	Open a proposal on a joint account for co-owners to approve

To pay someone from a sub-account, use moneda payment send --from sub-account:<UUID>.

Creating, closing, unfreezing and managing members of a sub-account stay in the Moneda mobile app.

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

moneda api-key — API keys

Command	Description
`moneda api-key list`	List your API keys: name, prefix, permissions, last use, expiry. Never shows the secret
`moneda api-key create --name "export script" --scopes "read:balances,read:transactions" [--expires-in-days 90]`	Create a key. The secret is printed once — store it immediately, it can’t be retrieved again
`moneda api-key revoke --key-id <UUID>`	Revoke a key. It stops working on its next request

Use a key with --api-key (or moneda config set api_key mnd_…) to run the CLI without logging in — handy in CI. A key can never carry more access than the credential that created it, and never covers payments.

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\|MXN]`	Annual percentage yield (APY) rates for earnings products
`moneda rates exchange [--from USD\|EUR\|CHF\|CAD\|MXN] [--to USD\|EUR\|CHF\|CAD\|MXN]`	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\|MXN]`	Spending totals by transaction type group
`moneda spending by-category --currency USDC\|EURC\|CHFAU\|CADD\|MXNB [--period 1d\|1w\|1m\|1y \| --from DATE --to DATE]`	Spending grouped by user-assigned category
`moneda spending by-contact --currency USDC\|EURC\|CHFAU\|CADD\|MXNB --recipient-account-id <UUID> [--period 1d\|1w\|1m\|1y \| --from DATE --to DATE]`	Total sent to a single recipient
`moneda spending by-merchant --currency USDC\|EURC\|CHFAU\|CADD\|MXNB [--period 1d\|1w\|1m\|1y \| --from DATE --to DATE]`	Spending grouped by recipient/merchant
`moneda spending comparison --currency USDC\|EURC\|CHFAU\|CADD\|MXNB --current-from DATE --current-to DATE --previous-from DATE --previous-to DATE`	Compare spending across two arbitrary windows
`moneda spending daily --currency USDC\|EURC\|CHFAU\|CADD\|MXNB [--period 1d\|1w\|1m\|1y \| --from DATE --to DATE]`	Daily series of spending totals for a stablecoin
`moneda spending transactions [--currency USDC\|EURC\|CHFAU\|CADD\|MXNB] [--period 1d\|1w\|1m\|1y \| --from DATE --to DATE] [--bucket-kind category\|merchant] [--bucket-id ID] [--recipient-account-id UUID] [--order-by createdAt\|amount] [--direction asc\|desc] [--take N] [--skip N]`	Drill into the underlying transactions for a window or bucket

summary is the odd one out: it reports fiat totals and takes --period 7d\|30d\|90d. Every other breakdown is denominated in the stablecoin actually held, so --currency is required and takes USDC, EURC, CHFAU, CADD or MXNB with a 1d\|1w\|1m\|1y window.

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 --receipt-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 <receiptId> [-o FILE]`	Fetch the presigned URL and write bytes to disk
`moneda receipt reparse --receipt-id <UUID>`	Re-run extraction on the stored file, no re-upload. For a failed parse or after a model upgrade
`moneda receipt attach --receipt-id <UUID> --transaction-id <ID>`	Link a receipt to a transaction
`moneda receipt detach --receipt-id <UUID>`	Unlink a receipt from its transaction
`moneda receipt confirm-suggestion --receipt-id <UUID>`	Accept the OCR auto-match suggestion
`moneda receipt reject-suggestion --receipt-id <UUID>`	Reject the OCR auto-match suggestion
`moneda receipt mark-partial-payment --receipt-id <UUID>`	Mark a receipt as a partial payment so an expected amount mismatch stops warning
`moneda receipt update-amounts --receipt-id <UUID> [--total-amount-value N] [--tax-rate-value PCT] …`	Correct the total, subtotal, tax, tax rate (percent) or tip
`moneda receipt add-line-item --receipt-id <UUID> --description … --total-price …`	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 --receipt-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 --bill-id <UUID>`	Show full extracted detail for one bill (merchant, IBAN/BIC, due date, presigned download URL)
`moneda bill download <billId> [-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 --charge-transaction-id <ID>`	Generate (idempotently) the ZUGFeRD invoice for a charge and return a 1h presigned download URL

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, pause/resume, and proposing a recurring payment. 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. A proposal waits for the user to activate it in the app.

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 propose --payment-type <TYPE> --amount <N> --currency <CUR> --frequency <FREQ> --start-date <YYYY-MM-DD>`	Propose a recurring payment (the user activates it in the Moneda app)
`moneda scheduled-tx resume --id <UUID>`	Resume execution (any window that elapsed while paused is skipped, never run retroactively)

conditional-order / conditional-orders — Crypto conditional orders

Read and cancel crypto limit, stop-loss, take-profit and trailing-stop orders. Creating an order is app-only: it needs your passkey to sign. cancel needs the write:trades scope.

Command	Description
`moneda conditional-order list`	List your crypto conditional orders, newest first
`moneda conditional-order get --id <UUID>`	Show full detail for one order
`moneda conditional-order cancel --id <UUID>`	Cancel an order, or every remaining repeat of a repeating rule (a live order is withdrawn from the order book on-chain first)

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 unset <key>`	Remove a configuration value
`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
`moneda api-schema`	Print the full OpenAPI document
`moneda api-schema --paths [--grep TEXT]`	List one line per endpoint

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"}'

api-schema (aliased schema) asks the deployment what it actually serves, rather than what these docs say. It needs no login, so it also works before you authenticate.

moneda api-schema --paths                 # every endpoint, method + path
moneda api-schema --paths --grep receipts # just the receipt endpoints
moneda api-schema | jq '.info.version'    # the full OpenAPI document

Both commands exit non-zero when the request fails, so they compose in scripts: moneda api GET /v1/balances || echo "unreachable".

CLI

What’s next?

CLI Examples

CLI Authentication

API Endpoints

Scopes

​What’s next?

CLI Examples

CLI Authentication

API Endpoints

Scopes

What’s next?