query-address-info — Claude Code skill: wallet token holdings
Lists the tokens held by one wallet address on BSC, Solana, Base or Ethereum, with price, 24h change and quantity.
npx skills add binance/binance-skills-hub --skill query-address-info -a claude-codeWhat query-address-info does
Give the skill a wallet address and a chainId, and it returns every token sitting on that address. Each entry carries the token name, symbol, current price, 24-hour change and remaining quantity. The work goes through a CLI script, scripts/cli.mjs, using its positions subcommand.
Four chains are covered: BSC (56), Solana (CT_501), Base (8453) and Ethereum (1). Every call needs offset, the first one included — leave it out and the upstream validation rejects the request. Start at 0 and keep raising it until data.list comes back empty or shorter than a page.
The fields price, percentChange24h and remainQty arrive as strings, so convert them before doing any math. icon holds a relative path; prefix it with https://bin.bnbstatic.com to render the image. Per-subcommand invocations, parameter tables and sample responses live in references/cli.md.
What it helps with
- see which tokens a wallet currently holds
- check price and 24h change for each holding
- pull balances for an address on BSC or Base
- inspect a Solana wallet portfolio
- page through token data for a large address
Example prompts for the agent
- List the tokens on
0x...on BSC - What's in my wallet on Base?
- Show holdings for this address on Ethereum with price and 24h change
How to install query-address-info
1Skills CLI (Vercel)
npx skills add binance/binance-skills-hub --skill query-address-info -a claude-code2Manually: put the files in place
~/.claude/skills/query-address-info/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/query-address-info/
1Skills CLI (Vercel)
npx skills add binance/binance-skills-hub --skill query-address-info -a codex2Manually: put the files in place
.agents/skills/query-address-info/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add binance/binance-skills-hub --skill query-address-info -a cursor2Manually: put the files in place
.cursor/skills/query-address-info/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install binance/binance-skills-hub query-address-info2Manually: put the files in place
.github/skills/query-address-info/SKILL.md1Skills CLI (Vercel)
npx skills add binance/binance-skills-hub --skill query-address-info -a gemini-cli2Platform CLI
gemini skills install https://github.com/binance/binance-skills-hub --path skills/binance-web3/query-address-infoManually: put the files in place
.devin/skills/query-address-info/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add binance/binance-skills-hub --skill query-address-info -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about query-address-info
How do I install query-address-info in Claude Code?
Run npx skills add binance/binance-skills-hub --skill query-address-info -a claude-code. The skill then lands at ~/.claude/skills/query-address-info/SKILL.md.
What does query-address-info do?
It returns a snapshot of the tokens on a single address in a chosen chain: name, symbol, price, 24h change and quantity.
Why does my call fail with a validation error?
Most likely offset is missing. It is required even on the first call — pass 0, then increment it for later pages.
