skilld
All skills
binance avatar

/query-address-info

@d34f8c6
by binancebinance/binance-skills-hub1k stars
232

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/binance/binance-skills-hub/query-address-info

This session only. Nothing lands on disk.

SKILL.md

≈116 tokens always: the name and description. ≈430 when used: this file. ≈565 more on demand in 1 file.

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

  • 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 for per-subcommand invocations, parameter tables, return-field tables, and real response samples.

Source: SKILL.md on GitHub

Third-party checks

1 warning17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The skill allows querying wallet token balances and prices using official Binance Web3 APIs. It includes a self-contained Node.js script that performs network requests to verified vendor domains. The implementation follows security best practices, including robust input validation and sanitization for blockchain addresses, and no malicious patterns were detected.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at d34f8c6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 4 months ago

Capability

metadata
{
  "author": "binance-web3-team",
  "version": "2.0"
}

Topics

  • wallet
  • blockchain
  • token-holdings
  • portfolio
  • price-data
  • bsc
  • ethereum
  • solana
  • base
  • web3

README badge

README badge for binance/binance-skills-hub/query-address-info

What it does

Fetches all tokens held by a wallet address on BSC, Solana, Base, or Ethereum, returning each token's name, symbol, price, 24-hour change, and quantity. Use when a user provides a wallet address and wants to see their current portfolio breakdown.

Generated from the current SKILL.md.

Frequently asked

What chains does this skill support?
BSC, Solana, Base, and Ethereum. Each chain has a specific chainId (e.g. 56 for BSC, CT_501 for Solana, 8453 for Base, 1 for Ethereum).
How do I paginate through results if a wallet holds many tokens?
Pass offset=0 for the first page, then increment the offset value and repeat the call until the returned list is empty or shorter than the page size.
Do I need to provide the offset parameter on the first call?
Yes. The offset parameter is required on every call, including the first one. Pass 0 to fetch the first page.
What format are the numeric values returned in?
Price, 24h price change percentage, and holding quantity are returned as strings and must be converted to numbers before performing arithmetic operations.

Generated from the current SKILL.md. These answers refresh after source changes.