CLI Examples - Moneda Docs

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:

moneda account balance

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 contact

Add a Moneda user to your contacts:

moneda contact add alice

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:

moneda recovery config

List the recovery emails on file:

moneda recovery emails-list

See if a recovery is currently in flight on your account:

moneda recovery status

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.

​Check your balance

​List recent transactions

​Send a payment

​Export transactions for taxes

​Add a contact

​Search the knowledge base

​Check your inbox

​Audit your recovery setup

​Categorize a CSV worth of transactions

​Look at your vaults

​Use with scripts

​What’s next?

Command Reference

CLI Authentication

REST API

Use Cases

Check your balance

List recent transactions

Send a payment

Export transactions for taxes

Add a contact

Search the knowledge base

Check your inbox

Audit your recovery setup

Categorize a CSV worth of transactions

Look at your vaults

Use with scripts

What’s next?