moonpay-export-data

データのエクスポート

目的

jq を使って、mp の出力をパイプで渡し、ポートフォリオのスナップショットや取引履歴を 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

マルチチェーンのポートフォリオ

チェーンをループして、1 つのファイルに追記します：

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> を直接使用します
• EVM アドレスは ethereum、base、polygon、arbitrum、optimism、bnb、avalanche で共通です

関連スキル

• moonpay-check-wallet — 残高をインタラクティブに表示します
• moonpay-block-explorer — エクスポートした取引をブロックエクスプローラーで開きます
• moonpay-trading-automation — 定期的なエクスポートと組み合わせて、日次スナップショットを作成します