Wallet Portfolio X402

ウォレットポートフォリオトラッカー API

チェーンをまたいだ暗号資産ウォレットの全保有状況を確認できます。ETH、ERC-20 トークン、USD 評価額に対応しています。エージェント向けのポートフォリオ追跡機能です。x402（Base L2 上の USDC）による従量課金で、API キーも登録も不要です。レート制限に阻まれることもありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API が 100 種類あり、必要なのはウォレット 1 つと Base 上の USDC だけです。

クイックスタート -- MCP

MCP クライアントの設定（Claude Desktop、Cursor、ElizaOS など）に追加します。

{
  "mcpServers": {
    "wallet-portfolio": {
      "url": "https://wallet-portfolio.api.klymax402.com/mcp"
    }
  }
}

クイックスタート -- HTTP（x402）

curl "https://wallet-portfolio.api.klymax402.com/api/portfolio?address=0x0000000000000000000000000000000000dEaD"
# -> 402 Payment Required, with an x402 payment challenge in the response body

x402 対応クライアント（@x402/fetch、x402-agent-tools、ATXP）は、402 → 署名 → 再試行のサイクルを自動的に処理します。

ツール

ツール	メソッド	パス	価格	説明
wallet_get_portfolio	GET	/api/portfolio	$0.008	すべてのトークン残高と USD 評価額を含む、ポートフォリオ全体を取得します
wallet_get_portfolio	POST	/api/portfolio	$0.008	すべてのトークン残高と USD 評価額を含む、ポートフォリオ全体を取得します（POST 版）
wallet_get_balance	GET	/api/balance	$0.003	ETH と USDC の残高のみを取得します
wallet_get_balance	POST	/api/balance	$0.003	ETH と USDC の残高のみを取得します（POST 版）

wallet_get_portfolio

暗号資産ウォレットのチェーンをまたいだ保有状況を確認する場合に使います。ポートフォリオの内訳全体を JSON 形式で返します。

パラメーター

名前	型	必須	説明
address	string	はい	ウォレットアドレス（0x...）
chain	string	いいえ	ブロックチェーンネットワーク（デフォルト：base）

戻り値

• nativeBalance -- USD 評価額を含む ETH 残高
• tokens -- シンボル、残高、USD 評価額、コントラクトアドレスを含む ERC-20 トークンの配列
• totalValueUsd -- ポートフォリオ全体の USD 評価額
• chain -- 照会したネットワーク

レスポンスの例：

{"nativeBalance":{"symbol":"ETH","balance":"1.234","valueUsd":3827.50},"tokens":[{"symbol":"USDC","balance":"500.00","valueUsd":500.00}],"totalValueUsd":4327.50,"chain":"base"}

使用する場面：スワップの実行時に、ウォレットに十分な残高があることを確認する場合です。ポートフォリオの追跡、残高の確認、エージェントによる自己報告に不可欠です。

用途外：ガス価格（gas_get_current_price を使用）、スワップ見積もり（dex_get_swap_quote を使用）、利回りの機会（defi_find_best_yields を使用）。

wallet_get_portfolio

暗号資産ウォレットのチェーンをまたいだ保有状況を確認する場合に使います。ポートフォリオの内訳全体を JSON 形式で返します。

パラメーター

名前	型	必須	説明
address	string	はい	ウォレットアドレス（0x...）
chain	string	いいえ	ブロックチェーンネットワーク（デフォルト：base）

戻り値

• nativeBalance -- USD 評価額を含む ETH 残高
• tokens -- シンボル、残高、USD 評価額、コントラクトアドレスを含む ERC-20 トークンの配列
• totalValueUsd -- ポートフォリオ全体の USD 評価額
• chain -- 照会したネットワーク

レスポンスの例：

{"nativeBalance":{"symbol":"ETH","balance":"1.234","valueUsd":3827.50},"tokens":[{"symbol":"USDC","balance":"500.00","valueUsd":500.00}],"totalValueUsd":4327.50,"chain":"base"}

使用する場面：スワップの実行時に、ウォレットに十分な残高があることを確認する場合です。ポートフォリオの追跡、残高の確認、エージェントによる自己報告に不可欠です。

用途外：ガス価格（gas_get_current_price を使用）、スワップ見積もり（dex_get_swap_quote を使用）、利回りの機会（defi_find_best_yields を使用）。

wallet_get_balance

ウォレットの ETH と USDC の残高だけを手早く確認したい場合に使用します。軽量な JSON レスポンスを返すため、ポートフォリオ全体を取得するよりも低コストです。

パラメーター

名前	型	必須	説明
address	文字列	はい	ウォレットアドレス（0x...）
chain	文字列	いいえ	ブロックチェーンネットワーク（デフォルト：base）

戻り値

• ethBalance -- USD 換算額を含むネイティブ ETH 残高
• usdcBalance -- USD 換算額を含む USDC 残高
• chain -- 照会したネットワーク

レスポンス例：

{"ethBalance":{"balance":"2.5","valueUsd":7750.00},"usdcBalance":{"balance":"1000.00","valueUsd":1000.00},"chain":"base"}

使用する場面：ETH と USDC だけを確認したい場合の、取引前の簡易的な残高確認。wallet_get_portfolio より高速で低コストです。

対象外：すべてのトークンを含むポートフォリオ全体（wallet_get_portfolio を使用）、ガス価格（gas_get_current_price を使用）。

wallet_get_balance

ウォレットの ETH と USDC の残高だけを手早く確認したい場合に使用します。軽量な JSON レスポンスを返すため、ポートフォリオ全体を取得するよりも低コストです。

パラメーター

名前	型	必須	説明
address	文字列	はい	ウォレットアドレス（0x...）
chain	文字列	いいえ	ブロックチェーンネットワーク（デフォルト：base）

戻り値

• ethBalance -- USD 換算額を含むネイティブ ETH 残高
• usdcBalance -- USD 換算額を含む USDC 残高
• chain -- 照会したネットワーク

レスポンス例：

{"ethBalance":{"balance":"2.5","valueUsd":7750.00},"usdcBalance":{"balance":"1000.00","valueUsd":1000.00},"chain":"base"}

使用する場面：ETH と USDC だけを確認したい場合の、取引前の簡易的な残高確認。wallet_get_portfolio より高速で低コストです。

対象外：すべてのトークンを含むポートフォリオ全体（wallet_get_portfolio を使用）、ガス価格（gas_get_current_price を使用）。

エージェントのプロンプト例

• 「暗号資産ウォレットの保有資産をチェーン間で確認する」
• 「暗号資産ウォレットの保有資産をチェーン間で確認する」
• 「ウォレットの ETH と USDC の残高だけを手早く確認する」

支払い

• プロトコル：x402 -- HTTP ネイティブの従量課金で、登録も API キーも不要です
• ネットワーク：Base L2（eip155:8453）
• 資産：USDC
• ファシリテーター：Coinbase CDP（プライマリ）、PayAI（フォールバック）
• ATXP 経由でも利用できます（OAuth でラップされた x402、RFC 9728 の保護対象リソースメタデータ）

klymax402 の一部

AI エージェント向けの x402 マイクロペイメント API 100 種類。ウォレット 1 つ、Base 上の USDC、登録不要です。

• カタログ：https://klymax402.com/llms.txt
• API リファレンス全文：https://klymax402.com/llms-full.txt
• リアルタイム統計：https://klymax402.com/stats

ライセンス

MIT