query-address-info Skill (Binance) for Claude Code: What It Does and How to Install It

Makes Claude list every token a wallet address holds, with price, 24-hour change and quantity.

Installs: 8.9K; on skills.sh
Stars: 1.1K; on GitHub
Files: 2; besides SKILL.md
Updated: Oct 2026; last repo commit

You give Claude a wallet address and a chain. It runs the bundled script with the positions command and returns each token's name, symbol, current price, 24-hour price change and holding quantity, paging through results with an offset that must be sent on every call, including the first. It is a lookup for one address, not a trading tool.

It needs Node.js and runs scripts/cli.mjs. The script sends the address and chain to a Binance Web3 endpoint, and the script reads no environment variables, so no key is asked for. This is the Binance Skills Hub repo, whose README lists Node.js 22 or newer.

Good for

People who have a wallet address and want its current token breakdown
Anyone checking positions on BSC, Solana, Base or Ethereum
Developers wiring a wallet portfolio lookup into an agent

Install query-address-info

Claude Code

Copy this prompt.

Install the query-address-info skill in Claude Code. Run this command:

npx skills add https://github.com/binance/binance-skills-hub --skill query-address-info

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 22 or newer.

The README command installs the whole Binance Skills Hub, not just this skill, and lists Node.js 22 or newer. The skills CLI route with --skill installs only this one. The skill runs a bundled Node script, so there is no Claude app upload route.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

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>".

Sections in SKILL.md

Overview
When to Use This Skill
Supported Chains
How to Call APIs
Commands
Rules
Full CLI Reference

Key facts

Author: Binance (vendor's own repo; SKILL.md metadata author: binance-web3-team)
License: Not stated in SKILL.md or a LICENSE file in the repo tree
Installs on skills.sh: 8,888 (Nov 2, 2026)
GitHub stars: 1,115 for the whole hub (Nov 2, 2026)
Last repo commit: Oct 26, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 3 files: SKILL.md, references/cli.md and scripts/cli.mjs
Chains: BSC (56), Solana (CT_501), Base (8453) and Ethereum (1) in SKILL.md and scripts/cli.mjs; references/cli.md lists only the first three
Needs: Node.js (README: 22 or newer)

What it includes

Lists a wallet's token holdings with price, 24-hour change and quantity
node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'
Try: “What tokens does 0x... hold on BSC?”
Runs code · positions
offset is required on every call; raise it until data.list is empty or short
Omitting offset causes an upstream validation error.
Runs code · Pagination
56 for BSC, CT_501 for Solana, 8453 for Base, 1 for Ethereum
references/cli.md lists only 56, 8453 and CT_501.
Read · Chain ids
price, percentChange24h and remainQty come back as strings and need converting
Icon paths are relative; prepend https://bin.bnbstatic.com to show them.
Read · Reading the numbers

From the official docs

Permissions

Low risk

The skill runs a local script that sends the wallet address you give it to a Binance endpoint. Use public addresses you are happy to look up.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The address you give is sent to Binance
The script builds a request to web3.binance.com with the address and chain in the query. Do not look up an address you want kept private. github.com
Chain lists disagree between files
SKILL.md lists four chains including Ethereum (1) and scripts/cli.mjs accepts all four chain ids, but references/cli.md lists only 56, 8453 and CT_501. Check Ethereum results. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only switch exists.
Talks to	web3.binance.com (wallet position lookups). bin.bnbstatic.com (token icon paths, only if you render them)
Sign-in and keys	The script reads no environment variables and SKILL.md names no key.
Scopes	Runs a bundled Node script (scripts/cli.mjs) Sends the wallet address and chain you provide to a Binance Web3 endpoint

Questions

What does the query-address-info skill do?

It makes Claude list the tokens held by one wallet address on a chain. For each token you get the name, symbol, price, 24-hour change and quantity held.

How do I install it?

Use the install box at the top of this page. The README gives one command that installs the whole Binance Skills Hub, and the box also lists a command for this skill only. You need Node.js.

Is it official?

Yes. It sits in the binance/binance-skills-hub repository, and SKILL.md names binance-web3-team as the author.

Which chains does it cover?

SKILL.md lists BSC (56), Solana (CT_501), Base (8453) and Ethereum (1), and the bundled scripts/cli.mjs accepts all four chain ids. The CLI reference, references/cli.md, lists only BSC, Base and Solana. The sources disagree on Ethereum, so check an Ethereum result before relying on it.

Does it need an API key or my wallet keys?

The script reads no environment variables and SKILL.md asks for a wallet address only. The README says some other Binance skills need API credentials, but this one does not use them. Our advice: never paste a seed phrase or private key into any prompt.

Is it safe?

It runs a local Node script that sends the address you give it to a Binance Web3 endpoint. SKILL.md defines one command, positions, which lists holdings.

Can it trade or send tokens?

SKILL.md defines one command, positions, which lists holdings. It defines none for trading or sending.

Information

updated Nov 2, 2026

Repository: binance/binance-skills-hub
Folder: skills/binance-web3/query-address-info

binance/binance-skills-hub skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

binance-skills-hub README · github.com
query-address-info SKILL.md · github.com
query-address-info references/cli.md · github.com
query-address-info cli.mjs · github.com