Wallet Balance Skill

Multi-chain asset overview. Zero config required.

What This Does

Query wallet balances across multiple chains:

• EVM Chains: Ethereum, BSC, Base, Arbitrum, Polygon
• Bitcoin: BTC addresses
• Address Memory: Remember addresses for quick re-query
• Portfolio View: Combined total across all chains

Optional: Configure Tokenview API for comprehensive token coverage.

Installation

Prerequisites

• Node.js 18+ - Required to run the gateway
• Redis (optional) - For caching and rate limiting

Quick Install

cd skills/wallet-balance
npm install
npm start

The gateway will start on port 3000 (or set

PORT

.env

Quick Start

# Query single address
curl "http://127.0.0.1:3000/agent-skills/v1/assets?input=0x..."

# Query from memory
curl "http://127.0.0.1:3000/agent-skills/v1/assets?from_memory=1"

# Add address to memory
curl -X POST "http://127.0.0.1:3000/agent-skills/v1/memory" \
  -H "Content-Type: application/json" \
  -d '{"add":"0x..."}'

Commands

Query Single Address

GET /agent-skills/v1/assets?input=<address-or-domain>

Parameters:

• input

  - Wallet address (0x..., bc1..., etc.) or ENS/BNB domain

• refresh=1

  - Skip cache and fetch fresh data

Example Response:

{
  "status": "ok",
  "address": "0x...",
  "total_usd": "5188.18",
  "chains": [
    {
      "chain": "Ethereum",
      "chain_id": 1,
      "tokens": [
        {
          "symbol": "USDT",
          "amount": "5185.5",
          "value_usd": "5184.26",
          "token_kind": "erc20"
        },
        {
          "symbol": "ETH",
          "amount": "0.00179932",
          "value_usd": "3.92",
          "token_kind": "native"
        }
      ]
    }
  ],
  "data_source": "public_only",
  "attribution": "Data aggregated by Antalpha AI"
}

Query Memory (Multiple Addresses)

GET /agent-skills/v1/assets?from_memory=1

Returns combined portfolio across all remembered addresses.

Memory Management

# List remembered addresses
GET /agent-skills/v1/memory

# Add address(es)
POST /agent-skills/v1/memory
Body: {"add": "0x..."} or {"add": ["0x...", "bc1..."]}

# Remove address
POST /agent-skills/v1/memory
Body: {"remove": "0x..."}

Supported Inputs

0x4Da2...C0490

bc1q...

1A...

vitalik.eth

example.bnb

Data Sources

Environment Variables

PORT

REDIS_URL

TOKENVIEW_API_KEY

ETH_RPC_URL

BNB_RPC_URL

Response Format

Single Address Response

• total_usd

  - Total portfolio value in USD

• chains[]

  - Assets grouped by chain

• chains[].tokens[]

  - Token balances and values

• data_source

  -

  public_only

  or

  tokenview

• attribution

  - Data source attribution

Memory Query Response

• query_mode: "memory"

• results[]

  - Array of individual address results

• combined_total_usd

  - Aggregated portfolio value

Security Notes

• Local HTTP Server: This skill starts a local HTTP server on the configured port (default 3000)
• File Persistence: Address memory is persisted to

  remembered-addresses.json

  by default, or the path specified by

  MEMORY_STORE_PATH

• External Requests: Wallet addresses are sent to external services (RPC providers, CoinGecko, optionally Tokenview)
• No Private Keys: This skill never requires or handles private keys
• Redis Optional: Service works without Redis, but with no caching or rate limiting
• Rate Limiting: When Redis is available, requests are rate-limited per IP and address

Health Check

curl http://127.0.0.1:3000/healthz

Maintainer: Antalpha AI Team
License: MIT