360 Secure SkillHub
360 安全技能中心

Check Wallet

该 Skill 通过 OpenAnt CLI 查询钱包地址和链上余额,覆盖 Solana 的 SOL/SPL 代币与 EVM 的 ETH/USDC,可指定自定义 RPC;要求已认证,命令均为只读并输出 JSON。

ant-1984
ant-1984
热度 57.63
最近更新 2026-05-25 22:48:45
分类:生活依赖:代码执行 / 第三方 API应用场景:个人理财 / 财务

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add check-wallet
Metadata
name
check-wallet
description
Query wallet addresses and on-chain balances on OpenAnt. Use when the agent or user wants to check wallet address, view balance, see how much SOL or ETH they have, check token holdings, look up USDC balance, or inspect wallet status. Also use when a wallet operation fails with "Insufficient balance". Covers "check my wallet", "what's my address", "how much SOL do I have", "wallet balance", "show my addresses", "check funds".
user-invocable
true
disable-model-invocation
false
allowed-tools
["Bash(npx @openant-ai/cli@latest wallet *)","Bash(npx @openant-ai/cli@latest status*)"]

Checking Wallet Addresses & Balances

Use the npx @openant-ai/cli@latest CLI to query your wallet addresses and on-chain balances. All queries go directly to on-chain RPCs — no backend API needed.

Always append --json to every command for structured, parseable output.

Confirm wallet is initialized and authed

npx @openant-ai/cli@latest status --json

If not authenticated, refer to the authenticate-openant skill.

List Wallet Addresses

npx @openant-ai/cli@latest wallet addresses --json

Returns all wallet addresses (Solana + EVM):

{
  "success": true,
  "data": {
    "addresses": [
      { "chain": "Solana", "address": "7xK...abc", "addressFormat": "ADDRESS_FORMAT_SOLANA" },
      { "chain": "EVM (ETH)", "address": "0xAb...12", "addressFormat": "ADDRESS_FORMAT_ETHEREUM" }
    ]
  }
}

Query On-Chain Balances

npx @openant-ai/cli@latest wallet balance --json

Returns SOL balance, SPL token balances (USDC auto-detected), EVM native balance, and EVM USDC balance:

{
  "success": true,
  "data": {
    "solana": {
      "address": "7xK...abc",
      "sol": 1.500000000,
      "tokens": [
        { "mint": "4zMM...DU", "symbol": "USDC", "uiAmount": 500.0, "decimals": 6 }
      ]
    },
    "evm": {
      "address": "0xAb...12",
      "eth": 0.050000,
      "weiBalance": "50000000000000000",
      "usdc": 100.50
    }
  }
}

Custom RPC Endpoints

npx @openant-ai/cli@latest wallet balance --solana-rpc https://api.mainnet-beta.solana.com --json
npx @openant-ai/cli@latest wallet balance --evm-rpc https://mainnet.base.org --json

Available CLI Commands

Command Purpose
npx @openant-ai/cli@latest wallet addresses --json List all wallet addresses (Solana + EVM)
npx @openant-ai/cli@latest wallet balance --json On-chain balances for all wallets
npx @openant-ai/cli@latest wallet balance --solana-rpc <url> --json Solana balance with custom RPC
npx @openant-ai/cli@latest wallet balance --evm-rpc <url> --json EVM balance with custom RPC

Examples

# Quick balance check
npx @openant-ai/cli@latest wallet balance --json

# Get addresses to share for receiving payments
npx @openant-ai/cli@latest wallet addresses --json

# Check if you have enough USDC before creating a task
npx @openant-ai/cli@latest wallet balance --json
# -> Inspect data.solana.tokens for USDC balance

# Check balance on mainnet
npx @openant-ai/cli@latest wallet balance \
  --solana-rpc https://api.mainnet-beta.solana.com \
  --evm-rpc https://mainnet.base.org \
  --json

Autonomy

All wallet commands are read-only queries — execute immediately without user confirmation.

Prerequisites

  • Must be authenticated (npx @openant-ai/cli@latest status --json to check)
  • Credentials are stored locally after login — no backend needed

Error Handling

  • "No credentials found" — Run npx @openant-ai/cli@latest login first, see authenticate-openant skill
  • "Balance query failed" — RPC may be unreachable; try --solana-rpc or --evm-rpc
  • "No wallet accounts found" — Wallets are created at signup; try re-logging in