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
offsetis required on every call — including the first page. Pass0to fetch the first page; increment for subsequent pages. Omitting it causes an upstream validation error.- Pagination: repeat with increasing
offsetuntildata.listis empty or shorter than the page size. - Icon URL prefix:
iconis a relative path (e.g.,/images/web3-data/public/token/logos/xxxx.png). Prependhttps://bin.bnbstatic.comto render. - Numbers as strings:
price,percentChange24h,remainQtyare 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.
