Index of every page on this site: llms.txt
All skills
binance avatar

/query-address-info

@7d1b1f7
by binancebinance/binance-skills-hub1.2k stars
281
Run it yourself

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

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

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

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

Description uses 5.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈463 characters, or 5.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    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.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

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

Last checked against GitHub last week.

Activeupdated 6 months ago
metadata
{
  "author": "binance-web3-team",
  "version": "2.0"
}
  • wallet
  • blockchain
  • token-holdings
  • portfolio
  • price-data
  • bsc
  • ethereum
  • solana
  • base
  • web3

README badge

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

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.

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.