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

# Money movement

> Check balances, create deposit quotes, inspect transactions, and send app-scoped transfers.

## Balance

Show USD balances across the account's wallets:

```bash theme={null}
hevn balance
hevn balance --yaml
```

To see the API key's remaining spend allowance, use `hevn whoami`.

Show the broader app account balance through account commands:

```bash theme={null}
hevn account list --yaml
```

## FX rates

Fetch a public FX rate to USD:

```bash theme={null}
hevn rate EUR
hevn rate --currency AED --yaml
```

## Crypto deposits

Create a deposit quote:

```bash theme={null}
hevn deposit 100 usdc base
```

Equivalent option form:

```bash theme={null}
hevn deposit --amount 100 --currency usdc --chain base
```

The result may include a deposit address and memo. Send funds only to the returned deposit details.

## Bank deposits

Incoming bank transfers settle directly against your bank details — see [Deposits & fiat payouts](/general/deposits-and-payouts). Check pending bank deposits:

```bash theme={null}
hevn pending-deposits
hevn pending-deposits --bank-id <bank-account-id> --yaml
```

## Pay an invoice

```bash theme={null}
hevn transfer --invoice-id <invoice-id> --memo "Invoice payment"
```

The command loads invoice details and submits an app-scoped transfer. The backend resolves the owning app from the configured API key; no app id is required.

## Transfer by email

```bash theme={null}
hevn transfer email vendor@example.com 25 --memo "Thanks"
```

If an email contact does not exist, the CLI creates one before submitting the transfer.

## Transfer to a contact

Send to an email or internal contact:

```bash theme={null}
hevn transfer contact <contact-id> 25 --memo "Thanks"
```

Send to a bank contact through a payout quote:

```bash theme={null}
hevn transfer contact \
  --contact-id <contact-id> \
  --amount 25 \
  --bank-account-id <bank-account-id> \
  --yes \
  --memo "Bank payout"
```

Use an existing quote:

```bash theme={null}
hevn transfer contact \
  --contact-id <contact-id> \
  --quote-id <quote-id> \
  --memo "Bank payout"
```

## Transactions

List recent transactions:

```bash theme={null}
hevn transfer list
hevn transfer list --limit 100 --offset 0 --yaml
```

## Pending transfer requests

Any transfer command can create a **pending request** instead of spending immediately — useful for operators whose transfers need the account owner's approval:

```bash theme={null}
hevn transfer contact <contact-id> 250 --request
hevn transfer email vendor@example.com 100 --request
hevn transfer pending          # list requests awaiting action
```

The owner approves or declines requests in the app (REST: `/transfer_requests`).

<Note>
  `hevn transfer email` and `hevn transfer contact` generate an idempotency key automatically when one is not supplied; `hevn transfer --invoice-id` does not. Pass `--idempotency-key` when replay protection must be controlled by your own system (and always for invoice transfers you may retry).
</Note>