DevX Multichain Balances

DevX 多链余额

一次调用，九条链。 查询 Base、Ethereum、Arbitrum、Optimism、Polygon、Avalanche、BNB Chain、Solana 和 Tron 上某个地址的原生币和主要代币。它专为需要回答“这个钱包里有什么？”的 AI Agent 和应用打造，无需自行配置 RPC。

这里的一切操作都是只读的。它不会索要密钥，也不会转移资金。

	内容	费用
CLI / stdio MCP devx-multichain-balances (v2)	下方托管 API 的客户端。单条链（原生币 + Tron 上的 USDC、USDT）免费；all / multichain_balances 是付费调用，使用你自己的钱包密钥支付	免费 / 0.002 USDC
远程 MCP https://wallet-balances.nextill-pos.workers.dev/mcp	basic_balance（单条链，免费）+ multichain_balances_info	免费
HTTP API GET /v1/balances	最多支持 3 个地址（一个 EVM、一个 Solana、一个 Tron）→ 每条 EVM 链上的原生币 + USDC、USDT、DAI、EURC、跨链 USDC、WETH、WBTC/cbBTC；SOL + USDC/USDT（SPL）；TRX + USDT/USDC（TRC-20）；另可添加最多 10 种自定义代币（ERC-20、SPL mint、TRC-20）。包括区块高度/槽位，以及按稳定币面值计算的总额	通过 x402 在 Base 上支付 0.002 USDC

在线服务：https://wallet-balances.nextill-pos.workers.dev · 代币列表：/tokens.json

CLI

npx devx-multichain-balances 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM          # free: SOL + USDC on Solana
npx devx-multichain-balances TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G                      # free: TRX + USDT on Tron
npx devx-multichain-balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain arbitrum   # free: ETH + USDC on Arbitrum

# paid, 0.002 USDC per call: every matching chain, all majors, custom tokens
export X402_PRIVATE_KEY=0x...   # a Base wallet holding a little USDC (use a dedicated low-balance wallet)
npx devx-multichain-balances all 0xd8dA...6045,9WzD...AWWM --chains base,ethereum,solana

支付方式：CLI 会向 API 请求 x402 报价，检查费用是否以 Base 上的 USDC 计价、支付地址是否为 0xB3cD…f247，以及金额是否不超过 --max-usd（默认为 0.01），然后通过 @x402/fetch 使用你的密钥签署免 Gas 的 EIP-3009 授权。密钥会保留在你的设备上。若未提供密钥，all 会显示报价、不支付费用，并以代码 2 退出。从 v2.0.0 起，该软件包只是一个轻量客户端，不再包含读取余额的代码，你查询的地址会发送到托管 API。

MCP

Claude Desktop / Cursor（stdio）：

{ "mcpServers": { "multichain-balances": { "command": "npx", "args": ["-y", "devx-multichain-balances", "mcp"], "env": { "X402_PRIVATE_KEY": "0x... (optional, enables the paid tool)" } } } }

或使用远程服务（可流式传输的 HTTP）：https://wallet-balances.nextill-pos.workers.dev/mcp（仅提供免费工具和信息）

工具：basic_balance（免费）、multichain_balances（每次调用 0.002 USDC；仅当设置了 X402_PRIVATE_KEY 时才会支付，且费用绝不会超过 0.01 USDC；否则返回报价）、multichain_balances_info。

付费托管调用（x402）

GET https://wallet-balances.nextill-pos.workers.dev/v1/balances?address=0x...,<solana>,<T...>[&chains=base,ethereum,solana,tron][&tokens=base:0xToken,solana:<mint>,tron:<T...>]

• 返回包含 x402 v1 正文（X-PAYMENT，网络为 base）的 402 响应，以及 v2 PAYMENT-REQUIRED 标头（PAYMENT-SIGNATURE，eip155:8453）。两者都可用。也支持携带 JSON 正文的 POST 请求。
• 支付 2000 个最小单位的 USDC（0.002 USDC）至 0xB3cDDccEe6B150c8efFD55B961afc0Ecefe7f247，通过 Coinbase CDP facilitator 结算，并已列入 CDP x402 Bazaar。
• 仅在生成结果之后结算。输入无效，或所有链的 RPC 都失败时，不会收费。失败的链会列在 summary.chains_failed 中。
• chains 默认为与你提供的地址匹配的所有链（evm = 7 条 EVM 链）。

限制

• 它不会发现任意代币，而是检查一份固定的已验证列表（参见 /tokens.json），你也可以自行传入额外代币。
• 在 Solana 上，它会读取所有者的关联代币账户（钱包通常在此存放代币）。其他代币账户中的代币不计入。
• 稳定币总额按面值计算（1 个代币 = 1 个单位），而非市场价格。
• 数据来自免费的公共 RPC 节点（publicnode.com，并在需要时回退：Solana 使用 mainnet-beta / Tatum gateway，Tron 使用 TronGrid）。20 秒内的相同调用可能会从每个实例的短期缓存中返回（cache.hit）。

OpenAPI：/openapi.json · 条款：/terms

相关 DevX 工具

• Address Poisoning Check：收款地址是否与您信任的地址相似？
• 7702 Sweeper Check：钱包上是否设置了 EIP-7702 清扫者委托？
• Crypto Link Check：加密货币网址是否是钓鱼或盗币网址的仿冒链接？

目录结构

• cli/：npm 包 devx-multichain-balances（CLI + 托管 API 的 stdio MCP 客户端），npm test
• worker/：托管 API 背后的 Cloudflare Worker（npm run build，npm test）

MIT。由 DevX 制作 · [email protected]