$npx -y skills add binance/binance-skills-hub --skill query-address-infoSnapshot of a single wallet's token holdings on a specific chain — list of every token currently held with name, symbol, current price, 24h price change, and holding quantity. Use when the user provides an explicit wallet address (or says "my wallet") and wants the current portfo
| 1 | # Query Address Info Skill |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | This skill queries any on-chain wallet address for token holdings, supporting: |
| 6 | |
| 7 | List of all tokens held by a wallet address |
| 8 | Current price of each token |
| 9 | 24-hour price change percentage |
| 10 | Holding quantity |
| 11 | |
| 12 | ## When to Use This Skill |
| 13 | |
| 14 | | User intent | Command | |
| 15 | |-------------|---------| |
| 16 | | List a wallet's token holdings with price and 24h change | `positions` | |
| 17 | |
| 18 | ## Supported Chains |
| 19 | |
| 20 | | Chain | chainId | |
| 21 | |-------|---------| |
| 22 | | BSC | `56` | |
| 23 | | Solana | `CT_501` | |
| 24 | | Base | `8453` | |
| 25 | | Ethereum | `1` | |
| 26 | |
| 27 | ## How to Call APIs |
| 28 | |
| 29 | ```bash |
| 30 | node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}' |
| 31 | ``` |
| 32 | |
| 33 | ## Commands |
| 34 | |
| 35 | | Command | Purpose | Required args | Example | |
| 36 | |---------|---------|---------------|---------| |
| 37 | | `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}'` | |
| 38 | |
| 39 | ## Rules |
| 40 | |
| 41 | - **`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. |
| 42 | - **Pagination**: repeat with increasing `offset` until `data.list` is empty or shorter than the page size. |
| 43 | - **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. |
| 44 | - **Numbers as strings**: `price`, `percentChange24h`, `remainQty` are strings — convert to numbers before arithmetic. |
| 45 | |
| 46 | ## Full CLI Reference |
| 47 | |
| 48 | See [`references/cli.md`](references/cli.md) for per-subcommand invocations, parameter tables, return-field tables, and real response samples. |