# Runes

Send, receive, and inspect Runes on Bitcoin L1.

### Check balance

```bash
xverse-wallet runes balance --json
```

Filter for specific runes:

```bash
xverse-wallet runes balance --filter "DOG" --json
```

### Receive Runes

```bash
xverse-wallet runes receive --json
```

Returns your taproot address for receiving Runes.

### Rune details

Look up a rune's etching info, divisibility, and supply before sending:

```bash
xverse-wallet runes details --rune "DOG•GO•TO•THE•MOON" --json
xverse-wallet runes details --rune 840000:3 --json
```

> **Important:** Rune amounts are raw integers (not decimal). Use `runes details` to check the rune's divisibility before sending.

### Send Runes

```bash
# Preview
xverse-wallet runes send --to <address> --rune 840000:3 --amount 1000 --json

# Execute
xverse-wallet runes send --to <address> --rune 840000:3 --amount 1000 --yes --json
```

#### Options

| Option              | Description                       |
| ------------------- | --------------------------------- |
| `--to <address>`    | Destination taproot address       |
| `--rune <id>`       | Rune name or ID (e.g. `840000:3`) |
| `--amount <int>`    | Amount as raw integer             |
| `--fee-rate <rate>` | Fee rate in sat/vB                |
| `--yes`             | Execute (omit for dry run)        |

### Transaction history

```bash
xverse-wallet runes history --rune 840000:3 --json
```
