Here are practical examples of everyday tasks you can accomplish with the Moneda CLI. All examples assume you’ve already authenticated with moneda auth login.
Check your balance See your current USD and EUR balances:
Get the output as JSON for scripting:
moneda account balance --output json
List recent transactions Show your last 10 transactions:
moneda transaction list --limit 10
Filter by currency and date range:
moneda transaction list --currency USD --from 2025-01-01 --to 2025-03-31
Send a payment Send $50 to a Moneda contact:
moneda payment send --to alice --amount 50 --currency USD
All payments require confirmation in the Moneda mobile app. The CLI will display a pending payment ID and wait for your approval.
Check on a pending payment:
moneda payment status pay_abc123
Export transactions for taxes Export all transactions from a specific year as CSV:
moneda transaction export --year 2025 --format csv > transactions-2025.csv
Or as JSON for further processing:
moneda transaction export --year 2025 --format json > transactions-2025.json
Add a Moneda user to your contacts:
Search for a user first if you’re not sure of their username:
moneda contact search "Alice Smith"
Search the knowledge base Find answers to common questions:
moneda knowledge search "how to deposit"
Check your inbox See unread in-app notifications without opening the app:
moneda notification list --filter unread --limit 10
Or just the count:
moneda notification unread-count
Audit your recovery setup Check whether ZK email recovery is fully configured:
List the recovery emails on file:
moneda recovery emails-list
See if a recovery is currently in flight on your account:
Categorize a CSV worth of transactions Bulk-categorize from a JSON file (max 25 per call):
cat > updates.json << 'EOF' [ { "transactionHash": "0xabc...", "category": "GROCERIES" }, { "transactionHash": "0xdef...", "category": "TRANSPORT" } ] EOF moneda transaction batch-categorize --file updates.json
Look at your vaults List your sub-accounts and aggregate wealth:
moneda sub-account list moneda wealth
Use with scripts The CLI is designed to work well with other command-line tools. Use --output json and pipe to jq, grep, or any other tool:
Get just your USD balance:
moneda account balance --output json | jq '.balances[] | select(.currency == "USD") | .balance'
Count transactions this month:
moneda transaction list --from 2025-03-01 --output json | jq '.transactions | length'
List all contacts as a simple name list:
moneda contact list --output json | jq -r '.contacts[].displayName'
Combine --quiet with --output json for clean, parseable output in automated scripts with no extra logging.
What’s next?
Command Reference Full reference of every CLI command and flag.
CLI Authentication Manage your CLI session and credentials.
REST API Use the REST API directly for deeper integrations.
Use Cases More ideas for what you can do with Moneda.
