moonpay-export-data

导出数据

目标

使用 mp 输出并通过 jq 处理，将投资组合快照和交易历史保存为 CSV 或 JSON 文件。适用于电子表格、税务申报和记录保存。

前提条件

• 已安装 jq：which jq
• 默认输出目录：~/Documents/moonpay/（如有需要，请创建）

将投资组合导出为 CSV

导出特定链上某个钱包的所有代币余额：

mkdir -p ~/Documents/moonpay

# Header + data
echo "symbol,name,amount,usd_value,price" > ~/Documents/moonpay/portfolio-$(date +%Y%m%d).csv

mp --json 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

多链投资组合

遍历各条链并追加到同一个文件中：

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 --json 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

注意：EVM 钱包在所有 EVM 链上共用同一个地址。Solana 使用不同的地址。

将交易历史导出为 CSV

导出兑换和跨链桥接历史记录。这些是在 CLI 中执行并通过 swaps.xyz 登记的交易，并非所有链上活动。

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 --json 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

按链筛选

mp --json transaction list --wallet <address> --chain solana \
  | jq -r '.items[] | ...' >> transactions.csv

将投资组合导出为 JSON

用于结构化数据或程序化处理：

mp --json 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

打开导出的文件

写入文件后，在默认应用中打开：

# 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

提示

• jq @csv 可正确处理 CSV 转义（引号、值中的逗号）
• 使用日期标记文件名以保留历史记录：portfolio-20260222.csv
• mp transaction list 仅包含通过 CLI 执行并经 swaps.xyz 登记的兑换和跨链桥接交易，不包含所有链上交易
• 如需快速查看摘要而不导出，可直接使用 mp token balance list --wallet <addr> --chain <chain>
• ethereum、base、polygon、arbitrum、optimism、bnb、avalanche 上的 EVM 地址相同

相关技能

• moonpay-check-wallet — 交互式查看余额
• moonpay-block-explorer — 在区块浏览器中打开导出的交易
• moonpay-trading-automation — 配合定时导出，生成每日快照