query-address-info

Query any on-chain wallet address token balances and positions. Retrieves all token holdings for a specified wallet address on a given chain, including token name, symbol, price, 24h price change, and holding quantity. Use this skill when users ask about wallet balance, token holds, portfolio, or asset positions for any blockchain address.

Query Address Info Skill

Overview

This skill queries any on-chain wallet address for token holdings, supporting:

List of all tokens held by a wallet address Current price of each token 24-hour price change percentage Holding quantity

When to Use This Skill

| User intent | Command | |-------------|---------| | List a wallet's token holdings with price and 24h change | positions |

Supported Chains

| Chain | chainId | |-------|---------| | BSC | 56 | | Solana | CT_501 | | Base | 8453 | | Ethereum | 1 |

How to Call APIs

node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'

Commands

| Command | Purpose | Required args | Example | |---------|---------|---------------|---------| | positions | List wallet token holdings (price + 24h change + quantity) | address, chainId, offset | node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}' |

Rules

offset is required on every call — including the first page. Pass 0 to fetch the first page; increment for subsequent pages. Omitting it causes an upstream validation error.
Pagination: repeat with increasing offset until data.list is empty or shorter than the page size.
Icon URL prefix: icon is a relative path (e.g., /images/web3-data/public/token/logos/xxxx.png). Prepend https://bin.bnbstatic.com to render.
Numbers as strings: price, percentChange24h, remainQty are strings — convert to numbers before arithmetic.

Full CLI Reference

See references/cli.md for per-subcommand invocations, parameter tables, return-field tables, and real response samples.