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

CODEBLOCK0

The gateway will start on port 3000 (or set PORT in .env).

Quick Start

CODEBLOCK1

Commands

Query Single Address

CODEBLOCK2

Parameters:

• - input - Wallet address (0x..., bc1..., etc.) or ENS/BNB domain
• INLINECODE3 - Skip cache and fetch fresh data

Example Response:
CODEBLOCK3

Query Memory (Multiple Addresses)

CODEBLOCK4

Returns combined portfolio across all remembered addresses.

Memory Management

CODEBLOCK5

Supported Inputs

Data Sources

Environment Variables

Response Format

Single Address Response

• - total_usd - Total portfolio value in USD
• INLINECODE15 - Assets grouped by chain
• INLINECODE16 - Token balances and values
• INLINECODE17 - public_only or INLINECODE19
• INLINECODE20 - Data source attribution

Memory Query Response

• - INLINECODE21
• INLINECODE22 - Array of individual address results
• INLINECODE23 - 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 INLINECODE25
• 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

CODEBLOCK6