mcpField
N
nansen-portfolio-tracker

nansen-portfolio-tracker

github.com/nansen-aiその他144444 回インストール今日更新
リポジトリ

nansen-portfolio-tracker について

nansen-portfolio-trackerは、Nansen CLIでウォレット資産の推移を調べるスキルです。アドレスの過去残高を取得して現在残高と比較でき、PnL情報も確認できます。

主な機能

  1. 01ウォレットの過去残高取得
  2. 02現在のオンチェーン残高確認
  3. 03過去と現在の保有状況比較
  4. 04取引PnLの確認

活用シーン

  1. 011か月間のウォレット資産変化の分析
  2. 02期間中に追加・除去されたトークンの特定
  3. 03ウォレットの取引成績の確認

MCP 対応

READMEでは、既存のOAuth/MCP `nansen:read` の仕様は変更されないと説明されています。このスキルはNansen CLIで調査コマンドを実行します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-portfolio-tracker

インストール後、Claude Code で/nansen-portfolio-trackerを入力して読み込まれたか確認します。

詳細

認証

ブラウザーログインでは、API キーと同等のアカウント API 権限を持つ nansen:api を要求します。既存の OAuth/MCP nansen:read の仕様と個別のウォレット認証は変更されません。

調査コマンドやループを実行する前に、明示的に選択した API キーまたは保存済みブラウザーセッションが必要です。まず nansen auth status を実行してください。キャッシュされた未検証のメタデータは、認証情報の有効性やストレージのロック解除を証明するものではありません。キャッシュされたアクセストークンの有効期限が切れているだけでは、セッションが使用できないとは限りません。CLI は通常、すでに認可済みの調査タスク中に、追加の同意要求や別途のアカウント確認なしで、選択済みセッションを自動更新します。匿名アクセスが選択されている場合、認証状態が無効な場合、更新またはクリーンアップがブロックされているか不確かな場合、または更新権限の拒否や期限切れを含む実際の認証エラーが発生した場合は、停止してください。CLI のエラーに記載された案内に従い、トラブルシューティングで求められた場合は無料の nansen account 確認を使用してください。失敗したキーの設定を解除したり、セッションを消去したり、再試行のために匿名アクセスへ切り替えたりしないでください。

新たにブラウザーで承認するには nansen login を使用するか、一般的な API キーを設定してください。NANSEN_API_KEY は保存済みセッションより優先されます。OpenClaw の任意設定である primaryEnv マッピングは、設定済みの API キーの注入を維持します。これは必須キーのゲートでも、認証済みであることの証明でもありません。通常のクレジットと利用権が適用されます。ログインによってクレジットが購入されることはありません。ブラウザーログインは CLI 2.0.0 で、macOS arm64 のプレビュー対象範囲内で利用できます。

API キーとブラウザーセッションは、同じ x402 の自動決済動作を使用します。対応する HTTP 402 チャレンジでは、既存のウォレット認証、決済ポリシー、支出上限に従い、設定済みのウォレットから資金が支払われる場合があります。ループ内の呼び出しを含め、各呼び出しで支払いが発生する可能性があります。認証、権限付与、セッション更新の失敗によって支払いが発生することはありません。また、ログイン確認と nansen account によって自動決済が行われることもありません。匿名での x402 は、明示的なユーザーの意図と決済設定を必要とする、独立した有料ワークフローとして引き続き利用できます。この調査ワークフローを匿名で実行したり、認証に失敗した後で匿名アクセスに切り替えたりしないでください。

ポートフォリオ履歴

回答する質問：「このウォレットのポートフォリオは、過去 1 か月でどのように推移しましたか？」

ADDR=<address> CHAIN=ethereum

nansen research profiler historical-balances --address $ADDR --chain $CHAIN --days 30 --limit 20
# → block_timestamp, token_symbol, token_amount, value_usd, chain

nansen research profiler balance --address $ADDR --chain $CHAIN
# → token_symbol, token_name, token_amount, price_usd, value_usd

nansen research profiler pnl --address $ADDR --chain $CHAIN --days 30 --limit 20
# → token_symbol, pnl_usd_realised, roi_percent_realised, bought_usd, sold_usd, holding_usd, nof_buys, nof_sells

過去の残高を現在の残高と時系列で比較すると、追加または削除されたものを確認できます。PnL は取引のパフォーマンスを示します。

コメント

Markdown 対応