query-address-info
Snapshot 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 portfolio: "what does 0x... hold", "wallet balance breakdown", "list positions for this address", "what tokens are in this wallet", "show me the holdings of <address>".
How do I install this agent skill?
npx skills add https://github.com/binance/binance-skills-hub --skill query-address-infoIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a legitimate tool for querying blockchain wallet balances and token positions via the official Binance Web3 API. It does not contain any malicious code, obfuscation, or unauthorized data access patterns.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/binance/binance-skills-hub/query-address-info">View query-address-info on skillZs</a>