> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moneda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Examples

> Common workflow examples using the Moneda CLI

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:

```bash theme={null}
moneda account balance
```

Get the output as JSON for scripting:

```bash theme={null}
moneda account balance --output json
```

## List recent transactions

Show your last 10 transactions:

```bash theme={null}
moneda transaction list --limit 10
```

Filter by currency and date range:

```bash theme={null}
moneda transaction list --currency USD --from 2025-01-01 --to 2025-03-31
```

## Send a payment

Send \$50 to a Moneda contact:

```bash theme={null}
moneda payment send --to alice --amount 50 --currency USD
```

<Warning>
  All payments require confirmation in the Moneda mobile app. The CLI will display a pending payment ID and wait for your approval.
</Warning>

Check on a pending payment:

```bash theme={null}
moneda payment status pay_abc123
```

## Export transactions for taxes

Export all transactions from a specific year as CSV:

```bash theme={null}
moneda transaction export --year 2025 --format csv > transactions-2025.csv
```

Or as JSON for further processing:

```bash theme={null}
moneda transaction export --year 2025 --format json > transactions-2025.json
```

## Add a contact

Add a Moneda user to your contacts:

```bash theme={null}
moneda contact add alice
```

Search for a user first if you're not sure of their username:

```bash theme={null}
moneda contact search "Alice Smith"
```

## Search the knowledge base

Find answers to common questions:

```bash theme={null}
moneda knowledge search "how to deposit"
```

## Check your inbox

See unread in-app notifications without opening the app:

```bash theme={null}
moneda notification list --filter unread --limit 10
```

Or just the count:

```bash theme={null}
moneda notification unread-count
```

## Audit your recovery setup

Check whether ZK email recovery is fully configured:

```bash theme={null}
moneda recovery config
```

List the recovery emails on file:

```bash theme={null}
moneda recovery emails-list
```

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

```bash theme={null}
moneda recovery status
```

## Categorize a CSV worth of transactions

Bulk-categorize from a JSON file (max 25 per call):

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
moneda account balance --output json | jq '.balances[] | select(.currency == "USD") | .balance'
```

Count transactions this month:

```bash theme={null}
moneda transaction list --from 2025-03-01 --output json | jq '.transactions | length'
```

List all contacts as a simple name list:

```bash theme={null}
moneda contact list --output json | jq -r '.contacts[].displayName'
```

<Info>
  Combine `--quiet` with `--output json` for clean, parseable output in automated scripts with no extra logging.
</Info>

## What's next?

<CardGroup cols={2}>
  <Card title="Command Reference" icon="book" href="/cli/commands">
    Full reference of every CLI command and flag.
  </Card>

  <Card title="CLI Authentication" icon="lock" href="/cli/authentication">
    Manage your CLI session and credentials.
  </Card>

  <Card title="REST API" icon="globe" href="/api/overview">
    Use the REST API directly for deeper integrations.
  </Card>

  <Card title="Use Cases" icon="lightbulb" href="/use-cases">
    More ideas for what you can do with Moneda.
  </Card>
</CardGroup>