Wallet Portfolio X402

钱包投资组合跟踪 API

跨链加密货币钱包持仓详情——ETH、ERC-20 代币、美元价值。为 Agent 提供投资组合跟踪。通过 x402 按次付费（在 Base L2 上使用 USDC）——无需 API 密钥、无需注册，也没有速率限制障碍。

这是 klymax402 市场的一部分——面向 AI Agent 的 100 个 x402 微支付 API，一个钱包，在 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	获取包含所有代币余额和美元价值的完整投资组合
wallet_get_portfolio	POST	/api/portfolio	$0.008	获取包含所有代币余额和美元价值的完整投资组合（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 -- ETH 余额及其美元价值
• tokens -- ERC-20 代币数组，包含符号、余额、美元价值和合约地址
• totalValueUsd -- 以美元计的投资组合总价值
• chain -- 查询的网络

响应示例：

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

适用场景：执行兑换前验证钱包余额是否充足。对于投资组合跟踪、余额检查和 Agent 自我报告至关重要。

不适用于：Gas 价格（使用 gas_get_current_price）、兑换报价（使用 dex_get_swap_quote）、收益机会（使用 defi_find_best_yields）。

wallet_get_portfolio

需要查看加密货币钱包在各条链上的持仓时使用。以 JSON 格式返回完整的投资组合明细。

参数

名称	类型	必填	描述
address	string	是	钱包地址（0x...）
chain	string	否	区块链网络（默认：base）

返回值

• nativeBalance -- ETH 余额及其美元价值
• tokens -- ERC-20 代币数组，包含符号、余额、美元价值和合约地址
• totalValueUsd -- 以美元计的投资组合总价值
• chain -- 查询的网络

响应示例：

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

适用场景：执行兑换前验证钱包余额是否充足。对于投资组合跟踪、余额检查和 Agent 自我报告至关重要。

不适用于：Gas 价格（使用 gas_get_current_price）、兑换报价（使用 dex_get_swap_quote）、收益机会（使用 defi_find_best_yields）。

wallet_get_balance

仅需快速查看钱包的 ETH 和 USDC 余额时使用。返回轻量级 JSON 响应，比完整投资组合更省成本。

参数

名称	类型	必填	描述
address	string	yes	钱包地址（0x...）
chain	string	no	区块链网络（默认：base）

返回值

• ethBalance -- 原生 ETH 余额及其美元价值
• usdcBalance -- 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 价格（使用 gas_get_current_price）。

wallet_get_balance

仅需快速查看钱包的 ETH 和 USDC 余额时使用。返回轻量级 JSON 响应，比完整投资组合更省成本。

参数

名称	类型	必填	描述
address	string	yes	钱包地址（0x...）
chain	string	no	区块链网络（默认：base）

返回值

• ethBalance -- 原生 ETH 余额及其美元价值
• usdcBalance -- 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 价格（使用 gas_get_current_price）。

Agent 提示词示例

• “查看加密货币钱包在各条链上的持仓”
• “查看加密货币钱包在各条链上的持仓”
• “快速查看钱包的 ETH 和 USDC 余额”

付款

• 协议：x402 —— 原生支持 HTTP 的按次付费，无需注册，无需 API 密钥
• 网络：Base L2（eip155:8453）
• 资产：USDC
• Facilitator：Coinbase CDP（主要），PayAI（备用）
• 也可通过 ATXP 访问（采用 OAuth 封装的 x402，受 RFC 9728 受保护资源元数据保护）

属于 klymax402

面向 AI Agent 的 100 个 x402 微支付 API —— 一个钱包、Base 上的 USDC、零注册。

• 目录：https://klymax402.com/llms.txt
• 完整 API 参考：https://klymax402.com/llms-full.txt
• 实时统计：https://klymax402.com/stats

许可证

MIT