Wallet Portfolio Tracker API

跨链的完整加密钱包持仓——ETH、ERC-20 代币、美元价值。面向代理的投资组合追踪。通过 x402 按调用付费（Base L2 上的 USDC）——无需 API 密钥、无需注册、无速率限制墙。

属于 klymax402 市场的一部分——为 AI 代理提供 100 个 x402 微支付 API，一个钱包，Base 上的 USDC。

快速入门 -- MCP

添加到你的 MCP 客户端配置（Claude Desktop、Cursor、ElizaOS 等）：

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

Related MCP server: AgentWallet MCP Server

快速入门 -- 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

当你需要检查加密钱包在多个链上的持仓时使用此工具。返回 JSON 格式的完整投资组合明细。

参数

返回值

• 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"}

使用场景：执行交换以验证钱包有足够余额。对于投资组合追踪、余额检查和代理自我报告至关重要。

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

wallet_get_portfolio

当你需要检查加密钱包在多个链上的持仓时使用此工具。返回 JSON 格式的完整投资组合明细。

参数

返回值

• 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"}

使用场景：执行交换以验证钱包有足够余额。对于投资组合追踪、余额检查和代理自我报告至关重要。

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

wallet_get_balance

当你只需要快速检查钱包的 ETH 和 USDC 余额时使用此工具。返回轻量级 JSON 响应——比完整投资组合更便宜。

参数

返回值

• 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 响应——比完整投资组合更便宜。

参数

返回值

• 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）。

示例代理提示

• "检查加密钱包在多个链上的持仓"

• "检查加密钱包在多个链上的持仓"

• "快速检查钱包的 ETH 和 USDC 余额"

支付

• 协议：x402 -- 原生 HTTP 按调用付费，无需注册，无需 API 密钥

• 网络：Base L2（eip155:8453）

• 资产：USDC

• 促进者：Coinbase CDP（主要），PayAI（备用）

• 也可通过 ATXP 访问（OAuth 包装的 x402，RFC 9728 受保护资源元数据）

属于 klymax402

为 AI 代理提供 100 个 x402 微支付 API——一个钱包，Base 上的 USDC，零注册。

• 目录：https://klymax402.com/llms.txt

• 完整 API 参考：https://klymax402.com/llms-full.txt

• 实时统计：https://klymax402.com/stats

许可证

MIT