query-address-info
binance/binance-skills-hub
Query wallet token holdings with current prices and 24h changes across multiple chains.
What is query-address-info?
Fetches a snapshot of all tokens held by a wallet address on supported blockchains (BSC, Solana, Base, Ethereum). Returns token names, symbols, current prices, 24-hour price changes, and holding quantities. Use when a user asks about a specific wallet's portfolio or token positions.
- List all tokens currently held by a wallet address
- Display current price for each token
- Show 24-hour price change percentage
- Return holding quantity for each position
- Support pagination for wallets with many tokens
- Work across BSC, Solana, Base, and Ethereum chains
How to install query-address-info
npx skills add https://github.com/binance/binance-skills-hub --skill query-address-info- Node.js installed
- Wallet address to query
- Chain ID for the target blockchain (56 for BSC, CT_501 for Solana, 8453 for Base, 1 for Ethereum)
How to use query-address-info
- 1.Identify the wallet address and target chain ID you want to query
- 2.Call the positions command with address, chainId, and offset=0
- 3.Parse the returned token list with name, symbol, price, 24h change, and quantity
- 4.For wallets with many tokens, increment offset and repeat until data.list is empty
- 5.Prepend https://bin.bnbstatic.com to icon paths to display token logos
- 6.Convert price, percentChange24h, and remainQty from strings to numbers for calculations
Use cases
- User asks 'what does wallet 0x... hold?' to see complete portfolio breakdown
- Portfolio analysis: retrieve all token positions and their current values
- Price tracking: check 24h changes for tokens in a specific wallet
- Multi-chain wallet inspection: query holdings on different blockchains
- Wallet comparison: fetch holdings from multiple addresses to compare positions
- Crypto traders analyzing wallet portfolios
- DeFi users tracking their token holdings
- Web3 developers building portfolio dashboards
- Wallet auditors reviewing token positions
- Investment analysts examining on-chain positions
query-address-info FAQ
BSC (chainId 56), Solana (chainId CT_501), Base (chainId 8453), and Ethereum (chainId 1).
Offset enables pagination through large token lists. Start with offset=0 for the first page, then increment for subsequent pages until the returned list is empty or shorter than page size.
Numeric values are returned as strings to preserve precision. Convert them to numbers before performing arithmetic operations.
Icon URLs are relative paths. Prepend https://bin.bnbstatic.com to the icon path to construct the full URL for rendering.
Each token includes: name, symbol, current price, 24-hour price change percentage, holding quantity, and icon URL.
Full instructions (SKILL.md)
Source of truth, from binance/binance-skills-hub.
name: query-address-info description: | 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>". metadata: author: binance-web3-team version: "2.0"
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.
Related skills
More from binance/binance-skills-hub and the wider catalog.
query-token-audit
Detect scams, honeypots, and malicious contracts before trading with comprehensive token security audits.
query-token-info
Search tokens and fetch real-time price, metadata, and candlestick data across Ethereum, BSC, Base, and Solana.
simple-earn
Manage Binance Simple Earn products and BFUSD/RWUSD accounts via authenticated API.
spot
Execute authenticated Binance Spot API requests for trading, market data, and order management.
square-post
Publish text, images, articles, and videos to Binance Square with a single command.
sub-account
Manage Binance sub-accounts via API: create, enable features, transfer assets, and monitor positions.