@moonpay/cli 0.5.2 → 0.6.0

package/skills/moonpay-block-explorer/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: moonpay-block-explorer
+description: Open transactions, wallets, and tokens in the correct block explorer. Use after swaps, bridges, or transfers to view results in the browser.
+tags: [explorer]
+---
+
+# Block explorer
+
+## Goal
+
+After any swap, bridge, or transfer, open the result in the correct block explorer. Also useful for viewing wallet addresses and token contract pages.
+
+## Explorer URLs
+
+| Chain | Transaction | Wallet | Token |
+|-------|------------|--------|-------|
+| solana | `https://solscan.io/tx/{sig}` | `https://solscan.io/account/{addr}` | `https://solscan.io/token/{addr}` |
+| ethereum | `https://etherscan.io/tx/{hash}` | `https://etherscan.io/address/{addr}` | `https://etherscan.io/token/{addr}` |
+| base | `https://basescan.org/tx/{hash}` | `https://basescan.org/address/{addr}` | `https://basescan.org/token/{addr}` |
+| polygon | `https://polygonscan.com/tx/{hash}` | `https://polygonscan.com/address/{addr}` | `https://polygonscan.com/token/{addr}` |
+| arbitrum | `https://arbiscan.io/tx/{hash}` | `https://arbiscan.io/address/{addr}` | `https://arbiscan.io/token/{addr}` |
+| optimism | `https://optimistic.etherscan.io/tx/{hash}` | `https://optimistic.etherscan.io/address/{addr}` | `https://optimistic.etherscan.io/token/{addr}` |
+| bnb | `https://bscscan.com/tx/{hash}` | `https://bscscan.com/address/{addr}` | `https://bscscan.com/token/{addr}` |
+| avalanche | `https://snowscan.xyz/tx/{hash}` | `https://snowscan.xyz/address/{addr}` | `https://snowscan.xyz/token/{addr}` |
+| bitcoin | `https://mempool.space/tx/{txid}` | `https://mempool.space/address/{addr}` | — |
+
+## Open a transaction
+
+After a swap or bridge, extract the chain and tx hash, then open:
+
+```bash
+# macOS
+open "https://solscan.io/tx/5rQ52JVb6q7H..."
+
+# Linux
+xdg-open "https://etherscan.io/tx/0xabcd..."
+```
+
+### From swap/bridge output
+
+`mp token swap` and `mp token bridge` return a result with the transaction signature. Use the chain to pick the correct explorer.
+
+```bash
+RESULT=$(mp -f compact token swap --wallet main --chain solana \
+  --from-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
+  --from-amount 1 \
+  --to-token So11111111111111111111111111111111111111111)
+
+# Open in browser
+SIG=$(echo "$RESULT" | jq -r '.signature')
+open "https://solscan.io/tx/$SIG"
+```
+
+### From transaction list
+
+`mp transaction list` returns transactions with `from.txHash` and `to.txHash`. Use the chain field to pick the explorer:
+
+```bash
+# View most recent transaction
+TX=$(mp -f compact transaction list --wallet <addr> | jq -r '.items[0].from.txHash')
+CHAIN=$(mp -f compact transaction list --wallet <addr> | jq -r '.items[0].from.chain')
+# Build URL from chain → explorer table above
+```
+
+## Open a wallet
+
+View all on-chain activity for a wallet address:
+
+```bash
+# Solana wallet
+open "https://solscan.io/account/N39jn2g1tA7dmdyyoHt9yiQegQoVhnfQzq1ZzuZRF9e"
+
+# EVM wallet (same address works on any EVM explorer)
+open "https://etherscan.io/address/0xf9e39F70d7636902e57a89C18B1BE39EBb5b9589"
+```
+
+Get wallet addresses from: `mp wallet list` or `mp wallet retrieve --wallet <name>`
+
+## Open a token page
+
+View token contract, holders, and market data on the explorer:
+
+```bash
+# USDC on Solana
+open "https://solscan.io/token/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+
+# USDC on Ethereum
+open "https://etherscan.io/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+```
+
+Get token addresses from: `mp token search --query "USDC" --chain solana`
+
+## Open a checkout URL
+
+`mp buy` returns a checkout URL. Open it directly:
+
+```bash
+URL=$(mp -f compact buy --token sol --amount 1 --wallet <addr> --email <email> | jq -r '.url')
+open "$URL"
+```
+
+## Platform detection
+
+```bash
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  open "$URL"
+else
+  xdg-open "$URL"
+fi
+```
+
+## Tips
+
+- After any swap, bridge, or transfer, offer to open the result in the explorer
+- EVM wallets share one address across all EVM chains — the same address works on etherscan, basescan, polygonscan, etc.
+- Bitcoin uses `mempool.space` — no token pages, just transactions and addresses
+- Solana signatures are base58 strings, EVM tx hashes start with `0x`
+
+## Related skills
+
+- **moonpay-swap-tokens** — Swap and bridge commands that produce transaction signatures
+- **moonpay-buy-crypto** — Buy commands that return checkout URLs
+- **moonpay-check-wallet** — Get wallet addresses to view on explorers

package/skills/moonpay-buy-crypto/SKILL.md

@@ -22,7 +22,7 @@ mp buy \
 
 ## Supported tokens
 
-`sol`, `usdc_sol`, `eth`, `usdc`, `usdc_base`, `usdc_arbitrum`, `usdc_optimism`, `usdc_polygon`, `eth_polygon`, `eth_optimism`, `eth_base`, `eth_arbitrum`
+`btc`, `sol`, `eth`, `trx`, `pol_polygon`, `usdc`, `usdc_sol`, `usdc_base`, `usdc_arbitrum`, `usdc_optimism`, `usdc_polygon`, `usdt_trx`, `eth_polygon`, `eth_optimism`, `eth_base`, `eth_arbitrum`
 
 ## Example flow
 

package/skills/moonpay-export-data/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: moonpay-export-data
+description: Export portfolio balances and transaction history to CSV or JSON files. Use for spreadsheets, tax reporting, or record-keeping.
+tags: [portfolio, export]
+---
+
+# Export data
+
+## Goal
+
+Save portfolio snapshots and transaction history to CSV or JSON files using `mp` output piped through `jq`. Useful for spreadsheets, tax reporting, and record-keeping.
+
+## Prerequisites
+
+- `jq` installed: `which jq`
+- Default output directory: `~/Documents/moonpay/` (create if needed)
+
+## Portfolio to CSV
+
+Export all token balances for a wallet on a specific chain:
+
+```bash
+mkdir -p ~/Documents/moonpay
+
+# Header + data
+echo "symbol,name,amount,usd_value,price" > ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+
+mp -f compact token balance list --wallet <address> --chain solana \
+  | jq -r '.items[] | [.symbol, .name, .balance.amount, .balance.value, .balance.price] | @csv' \
+  >> ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+```
+
+### Multi-chain portfolio
+
+Loop over chains and append to one file:
+
+```bash
+FILE=~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+echo "chain,symbol,name,amount,usd_value,price" > "$FILE"
+
+for CHAIN in solana ethereum base polygon arbitrum; do
+  mp -f compact token balance list --wallet <address> --chain "$CHAIN" \
+    | jq -r --arg chain "$CHAIN" '.items[] | [$chain, .symbol, .name, .balance.amount, .balance.value, .balance.price] | @csv' \
+    >> "$FILE" 2>/dev/null
+done
+```
+
+Note: EVM wallets share one address across all EVM chains. Solana uses a different address.
+
+## Transaction history to CSV
+
+Export swap and bridge history. These are transactions executed via the CLI and registered with swaps.xyz — not all on-chain activity.
+
+```bash
+echo "date,type,from_chain,from_token,from_amount,to_chain,to_token,to_amount,usd,status" \
+  > ~/Documents/moonpay/transactions-$(date +%Y%m%d).csv
+
+mp -f compact transaction list --wallet <address> \
+  | jq -r '.items[] | [
+      .transactionId,
+      .type,
+      .from.chain, .from.token, .from.amount,
+      .to.chain, .to.token, .to.amount,
+      .usd,
+      .status
+    ] | @csv' \
+  >> ~/Documents/moonpay/transactions-$(date +%Y%m%d).csv
+```
+
+### Filter by chain
+
+```bash
+mp -f compact transaction list --wallet <address> --chain solana \
+  | jq -r '.items[] | ...' >> transactions.csv
+```
+
+## Portfolio to JSON
+
+For structured data or programmatic use:
+
+```bash
+mp -f compact token balance list --wallet <address> --chain solana \
+  | jq '.items | map({symbol, amount: .balance.amount, usd: .balance.value})' \
+  > ~/Documents/moonpay/portfolio-$(date +%Y%m%d).json
+```
+
+## Open exported file
+
+After writing the file, open it in the default app:
+
+```bash
+# macOS — opens in Numbers/Excel
+open ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+
+# Linux
+xdg-open ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv
+```
+
+## Tips
+
+- `jq @csv` handles proper CSV escaping (quotes, commas in values)
+- Date-stamp filenames to keep a history: `portfolio-20260222.csv`
+- `mp transaction list` only includes CLI-executed swaps/bridges registered via swaps.xyz, not all on-chain transactions
+- For a quick summary without exporting, use `mp token balance list --wallet <addr> --chain <chain>` directly
+- EVM address is the same across ethereum, base, polygon, arbitrum, optimism, bnb, avalanche
+
+## Related skills
+
+- **moonpay-check-wallet** — View balances interactively
+- **moonpay-block-explorer** — Open exported transactions in block explorers
+- **moonpay-trading-automation** — Combine with scheduled exports for daily snapshots

package/skills/moonpay-polymarket-ready/SKILL.md

@@ -51,7 +51,7 @@ If the wallet already has POL and USDC.e, they're set.
 Buy POL directly with fiat — easiest way to get gas on Polygon:
 
 ```bash
-mp buy --token pol --amount 5 --wallet <eth-address> --email <email>
+mp buy --token pol_polygon --amount 5 --wallet <eth-address> --email <email>
 ```
 
 Alternatively, bridge ETH → POL if the user already has ETH:

package/skills/moonpay-price-alerts/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: moonpay-price-alerts
+description: Set up desktop price alerts that notify you when tokens hit target prices. Observe-only — no trading, just notifications.
+tags: [alerts, research]
+---
+
+# Price alerts
+
+## Goal
+
+Monitor token prices and get desktop notifications when they cross a threshold. Uses `mp token retrieve` for price checks and OS notifications (`osascript`/`notify-send`) for alerts. Observe-only — no funds at risk.
+
+## Prerequisites
+
+- `mp` binary on PATH: `which mp`
+- `jq` installed: `which jq`
+- macOS: `osascript` (built-in) or Linux: `notify-send` (`sudo apt install libnotify-bin`)
+
+## One-shot alert
+
+"Tell me when SOL drops below $80" — checks every 5 minutes, fires once, then disables itself.
+
+### Script: `~/.config/moonpay/scripts/alert-sol-below-80.sh`
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+MP="$(which mp)"
+LOG="$HOME/.config/moonpay/logs/alerts.log"
+mkdir -p "$(dirname "$LOG")"
+log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" >> "$LOG"; }
+
+# --- Config ---
+TOKEN="So11111111111111111111111111111111111111111"
+CHAIN="solana"
+SYMBOL="SOL"
+TARGET=80
+DIRECTION="below"  # "above" or "below"
+SCRIPT_NAME="alert-sol-below-80"
+
+# --- Check price ---
+PRICE=$("$MP" -f compact token retrieve --token "$TOKEN" --chain "$CHAIN" | jq -r '.marketData.price')
+
+if [ -z "$PRICE" ] || [ "$PRICE" = "null" ]; then
+  log "ALERT $SCRIPT_NAME: price fetch failed, skipping"
+  exit 0
+fi
+
+# --- Compare ---
+TRIGGERED=false
+if [ "$DIRECTION" = "below" ] && (( $(echo "$PRICE < $TARGET" | bc -l) )); then
+  TRIGGERED=true
+elif [ "$DIRECTION" = "above" ] && (( $(echo "$PRICE > $TARGET" | bc -l) )); then
+  TRIGGERED=true
+fi
+
+if [ "$TRIGGERED" = true ]; then
+  MSG="$SYMBOL is $DIRECTION \$$TARGET — currently \$$PRICE"
+  log "ALERT $SCRIPT_NAME: $MSG"
+
+  # Desktop notification
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    osascript -e "display notification \"$MSG\" with title \"MoonPay Alert\" sound name \"Glass\""
+  else
+    notify-send "MoonPay Alert" "$MSG"
+  fi
+
+  # Self-disable (one-shot)
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    launchctl unload "$HOME/Library/LaunchAgents/com.moonpay.${SCRIPT_NAME}.plist" 2>/dev/null || true
+  else
+    crontab -l | grep -v "$SCRIPT_NAME" | crontab -
+  fi
+  log "ALERT $SCRIPT_NAME: disabled after trigger"
+else
+  log "ALERT $SCRIPT_NAME: $SYMBOL at \$$PRICE — not triggered ($DIRECTION $TARGET)"
+fi
+```
+
+### Schedule
+
+Check every 5 minutes:
+
+```bash
+# cron (Linux)
+*/5 * * * * ~/.config/moonpay/scripts/alert-sol-below-80.sh # moonpay:alert-sol-below-80
+
+# launchd (macOS) — use StartInterval of 300 seconds in the plist
+```
+
+Launchd plist at `~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.moonpay.alert-sol-below-80</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>/Users/USERNAME/.config/moonpay/scripts/alert-sol-below-80.sh</string>
+  </array>
+  <key>StartInterval</key>
+  <integer>300</integer>
+  <key>StandardErrorPath</key>
+  <string>/Users/USERNAME/.config/moonpay/logs/alert-sol-below-80.err</string>
+</dict>
+</plist>
+```
+
+Load: `launchctl load ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist`
+
+**Important:** Replace `USERNAME` with the actual username. Tilde does not expand in plist files.
+
+## Recurring alert
+
+"Alert me every hour while ETH is above $2000" — keeps firing on each check, doesn't self-disable.
+
+Same script as above but remove the self-disable block. The alert fires every time the condition is met, until the user manually removes it.
+
+## Managing alerts
+
+### List active alerts
+
+```bash
+# macOS
+launchctl list | grep moonpay
+
+# Linux
+crontab -l | grep moonpay
+```
+
+### Remove an alert
+
+```bash
+# macOS
+launchctl unload ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist
+rm ~/Library/LaunchAgents/com.moonpay.alert-sol-below-80.plist
+
+# Linux
+crontab -l | grep -v "alert-sol-below-80" | crontab -
+```
+
+### View alert history
+
+```bash
+tail -50 ~/.config/moonpay/logs/alerts.log
+```
+
+## Tips
+
+- Price checks via `mp token retrieve` are free — no gas costs
+- 5-minute intervals are reasonable; don't go below 1 minute
+- Use `mp token search --query "SOL" --chain solana` to resolve token addresses
+- Alerts log to `~/.config/moonpay/logs/alerts.log` — check this to verify they're running
+- The machine must be logged in for notifications and keychain access to work
+- `bc -l` handles decimal comparison; if unavailable, use `awk "BEGIN {exit !($PRICE < $TARGET)}"`
+- This skill is observe-only — for automated buying/selling, see **moonpay-trading-automation**
+
+## Related skills
+
+- **moonpay-trading-automation** — Automated trading (DCA, limit orders, stop losses)
+- **moonpay-discover-tokens** — Research tokens and get current prices
+- **moonpay-check-wallet** — Check portfolio before setting alerts

package/skills/moonpay-trading-automation/SKILL.md

@@ -0,0 +1,276 @@
+---
+name: moonpay-trading-automation
+description: Set up automated trading strategies — DCA, limit orders, and stop losses — by composing mp CLI commands with OS scheduling (cron/launchd).
+tags: [trading, automation]
+---
+
+# Trading automation
+
+## Goal
+
+Compose `mp` CLI commands with OS scheduling (cron/launchd) to run unattended trading strategies: dollar-cost averaging, limit orders, and stop losses. The agent generates shell scripts and schedules them — no new tools needed.
+
+## Prerequisites
+
+- Authenticated: `mp user retrieve`
+- Funded wallet: `mp token balance list --wallet <name> --chain <chain>`
+- `mp` binary on PATH: `which mp` (note the full path for scheduled scripts)
+- `jq` installed: `which jq`
+
+## Shell script pattern
+
+Every strategy uses the same base pattern. Scripts live in `~/.config/moonpay/scripts/` and log to `~/.config/moonpay/logs/trading.log`.
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+MP="$(which mp)"  # absolute path for cron/launchd
+LOG="$HOME/.config/moonpay/logs/trading.log"
+mkdir -p "$(dirname "$LOG")"
+
+log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" >> "$LOG"; }
+
+# --- Config (agent fills these in) ---
+WALLET="main"
+CHAIN="solana"
+FROM_TOKEN="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"  # USDC
+TO_TOKEN="So11111111111111111111111111111111111111111"         # SOL
+AMOUNT=5
+
+# --- Execute ---
+log "SWAP: $AMOUNT $FROM_TOKEN -> $TO_TOKEN on $CHAIN"
+RESULT=$("$MP" -f compact token swap \
+  --wallet "$WALLET" --chain "$CHAIN" \
+  --from-token "$FROM_TOKEN" --from-amount "$AMOUNT" \
+  --to-token "$TO_TOKEN" 2>&1) || {
+  log "FAILED: $RESULT"
+  exit 1
+}
+log "OK: $RESULT"
+```
+
+Key points:
+- `mp -f compact` outputs single-line JSON, ideal for `jq` parsing
+- Use `$(which mp)` and store as `MP` — cron/launchd have minimal PATH
+- Wallet names only in scripts — `mp` handles keychain decryption at runtime
+- If the user gives token names/symbols, resolve to addresses first with `mp token search`
+
+## DCA (Dollar-Cost Averaging)
+
+"Buy $5 of SOL every day at 9am"
+
+### Script: `~/.config/moonpay/scripts/dca-sol.sh`
+
+Use the base pattern above with the user's token, amount, wallet, and chain.
+
+### Schedule with cron (Linux)
+
+```bash
+# Buy $5 of SOL daily at 9am UTC — moonpay:dca-sol
+0 9 * * * ~/.config/moonpay/scripts/dca-sol.sh
+```
+
+Add with: `(crontab -l 2>/dev/null; echo '0 9 * * * ~/.config/moonpay/scripts/dca-sol.sh # moonpay:dca-sol') | crontab -`
+
+Common intervals:
+- Every hour: `0 * * * *`
+- Every 4 hours: `0 */4 * * *`
+- Daily at 9am: `0 9 * * *`
+- Weekly Monday 9am: `0 9 * * 1`
+
+### Schedule with launchd (macOS)
+
+Write a plist to `~/Library/LaunchAgents/com.moonpay.dca-sol.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.moonpay.dca-sol</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>/Users/USERNAME/.config/moonpay/scripts/dca-sol.sh</string>
+  </array>
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>Hour</key>
+    <integer>9</integer>
+    <key>Minute</key>
+    <integer>0</integer>
+  </dict>
+  <key>StandardErrorPath</key>
+  <string>/Users/USERNAME/.config/moonpay/logs/dca-sol.err</string>
+</dict>
+</plist>
+```
+
+Load with: `launchctl load ~/Library/LaunchAgents/com.moonpay.dca-sol.plist`
+
+**Important:** Tilde (`~`) does NOT expand in plist files. Always use the full path (e.g., `/Users/USERNAME/...`). Get it with `echo $HOME`.
+
+## Limit order
+
+"Buy SOL when price drops below $80"
+
+### Script: `~/.config/moonpay/scripts/limit-buy-sol.sh`
+
+```bash
+#!/bin/bash
+set -euo pipefail
+
+MP="$(which mp)"
+LOG="$HOME/.config/moonpay/logs/trading.log"
+mkdir -p "$(dirname "$LOG")"
+log() { echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" >> "$LOG"; }
+
+# --- Config ---
+WALLET="main"
+CHAIN="solana"
+TOKEN="So11111111111111111111111111111111111111111"
+BUY_WITH="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"  # USDC
+BUY_AMOUNT=50
+TARGET_PRICE=80
+SCRIPT_NAME="limit-buy-sol"
+
+# --- Check price ---
+PRICE=$("$MP" -f compact token retrieve --token "$TOKEN" --chain "$CHAIN" | jq -r '.marketData.price')
+
+if [ -z "$PRICE" ] || [ "$PRICE" = "null" ]; then
+  log "LIMIT $SCRIPT_NAME: price fetch failed, skipping"
+  exit 0
+fi
+
+# --- Compare ---
+if (( $(echo "$PRICE < $TARGET_PRICE" | bc -l) )); then
+  log "LIMIT $SCRIPT_NAME: price $PRICE < $TARGET_PRICE — executing buy"
+  RESULT=$("$MP" -f compact token swap \
+    --wallet "$WALLET" --chain "$CHAIN" \
+    --from-token "$BUY_WITH" --from-amount "$BUY_AMOUNT" \
+    --to-token "$TOKEN" 2>&1) || {
+    log "LIMIT $SCRIPT_NAME FAILED: $RESULT"
+    exit 1
+  }
+  log "LIMIT $SCRIPT_NAME OK: bought at $PRICE — $RESULT"
+
+  # Self-disable after fill
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    launchctl unload "$HOME/Library/LaunchAgents/com.moonpay.${SCRIPT_NAME}.plist" 2>/dev/null || true
+  else
+    crontab -l | grep -v "$SCRIPT_NAME" | crontab -
+  fi
+  log "LIMIT $SCRIPT_NAME: disabled after fill"
+else
+  log "LIMIT $SCRIPT_NAME: price $PRICE >= $TARGET_PRICE — waiting"
+fi
+```
+
+Schedule every 5 minutes:
+- Cron: `*/5 * * * * ~/.config/moonpay/scripts/limit-buy-sol.sh # moonpay:limit-buy-sol`
+- Launchd: use `<key>StartInterval</key><integer>300</integer>` instead of `StartCalendarInterval`
+
+## Stop loss
+
+"Sell all my SOL if price drops below $70"
+
+Same structure as limit order but sells instead of buys. For "sell all", query the balance first:
+
+```bash
+# --- Config ---
+SELL_TOKEN="So11111111111111111111111111111111111111111"   # SOL
+TO_TOKEN="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" # USDC
+TRIGGER_PRICE=70
+SCRIPT_NAME="stop-loss-sol"
+
+# --- Check price ---
+PRICE=$("$MP" -f compact token retrieve --token "$SELL_TOKEN" --chain "$CHAIN" | jq -r '.marketData.price')
+
+if (( $(echo "$PRICE < $TRIGGER_PRICE" | bc -l) )); then
+  # Get current balance to sell all
+  BALANCE=$("$MP" -f compact token balance list --wallet "$WALLET" --chain "$CHAIN" \
+    | jq -r --arg addr "$SELL_TOKEN" '.items[] | select(.address == $addr) | .balance.amount')
+
+  if [ -n "$BALANCE" ] && (( $(echo "$BALANCE > 0" | bc -l) )); then
+    log "STOP-LOSS $SCRIPT_NAME: price $PRICE < $TRIGGER_PRICE — selling $BALANCE"
+    RESULT=$("$MP" -f compact token swap \
+      --wallet "$WALLET" --chain "$CHAIN" \
+      --from-token "$SELL_TOKEN" --from-amount "$BALANCE" \
+      --to-token "$TO_TOKEN" 2>&1) || {
+      log "STOP-LOSS $SCRIPT_NAME FAILED: $RESULT"
+      exit 1
+    }
+    log "STOP-LOSS $SCRIPT_NAME OK: sold at $PRICE — $RESULT"
+    # Self-disable (same pattern as limit order)
+  fi
+fi
+```
+
+## Managing automations
+
+### List active automations
+
+```bash
+# macOS
+launchctl list | grep moonpay
+
+# Linux
+crontab -l | grep moonpay
+```
+
+### Remove an automation
+
+```bash
+# macOS
+launchctl unload ~/Library/LaunchAgents/com.moonpay.dca-sol.plist
+rm ~/Library/LaunchAgents/com.moonpay.dca-sol.plist
+
+# Linux
+crontab -l | grep -v "moonpay:dca-sol" | crontab -
+```
+
+### View logs
+
+```bash
+tail -50 ~/.config/moonpay/logs/trading.log
+```
+
+### Pause / resume (macOS only)
+
+```bash
+launchctl unload ~/Library/LaunchAgents/com.moonpay.dca-sol.plist   # pause
+launchctl load ~/Library/LaunchAgents/com.moonpay.dca-sol.plist     # resume
+```
+
+## Platform detection
+
+Detect the OS and use the appropriate scheduler:
+
+```bash
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  # macOS: use launchd (fires even if machine was asleep)
+else
+  # Linux: use crontab
+fi
+```
+
+## Tips
+
+- Start with a small DCA amount to verify the setup works before going bigger
+- Check logs after the first run: `tail -20 ~/.config/moonpay/logs/trading.log`
+- Scripts don't contain secrets — `mp` decrypts wallets via OS keychain at runtime
+- The machine must be logged in (user session active) for keychain access to work
+- Price checks via `mp token retrieve` are free; swaps cost gas
+- Limit order checks every 5 minutes is reasonable — don't go below 1 minute
+- Use `bc -l` for decimal price comparison (bash can't compare floats natively)
+- If `bc` isn't available, use: `awk "BEGIN {exit !($PRICE < $TARGET)}"`
+- Always tag cron entries with `# moonpay:{name}` so they can be found and removed
+
+## Related skills
+
+- **moonpay-swap-tokens** — Swap and bridge command syntax
+- **moonpay-check-wallet** — Check balances before setting up automation
+- **moonpay-discover-tokens** — Research tokens and resolve addresses
+- **moonpay-price-alerts** — Observe-only price notifications (no trading)