Query Address Info

by binance9960c675387bNo license1K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 3 weeks ago

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

Includes scriptsData & Analytics
AI-generated overview

Queries a wallet address for its token holdings, prices, 24h change and quantities via a CLI script.

What it does
This skill looks up a single on-chain wallet address and returns the tokens it currently holds, with each token's name, symbol, current price, 24-hour price change and holding quantity. It supports BSC, Solana, Base and Ethereum, and paginates results by offset until the returned list is empty or short. It ships an executable Node script that performs the query and a reference document describing the CLI.
When to use it
Use it when a user gives an explicit wallet address, or refers to "my wallet", and wants a current portfolio breakdown. Typical requests include listing positions for an address, showing a wallet balance breakdown, or asking what tokens a wallet holds.
Requirements
A Node.js runtime to run the bundled scripts/cli.mjs script, plus network access to the upstream data service. Each call requires an address, a chainId and an offset argument.

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 intentCommand
List a wallet's token holdings with price and 24h changepositions

Supported Chains

ChainchainId
BSC56
SolanaCT_501
Base8453
Ethereum1

How to Call APIs

bash
node <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'

Commands

CommandPurposeRequired argsExample
positionsList wallet token holdings (price + 24h change + quantity)address, chainId, offsetnode <skill-dir>/scripts/cli.mjs positions '{"address":"0x...","chainId":"56","offset":0}'

Rules

  • 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.
  • Pagination: repeat with increasing offset until data.list is empty or shorter than the page size.
  • 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.
  • Numbers as strings: price, percentChange24h, remainQty are strings — convert to numbers before arithmetic.

Full CLI Reference

See references/cli.md [blocked] for per-subcommand invocations, parameter tables, return-field tables, and real response samples.

Source and attribution

Source:binance/binance-skills-hubinskills/binance-web3/query-address-infoat commit9960c67

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal