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.

referencescli.md

≈565 tokens on demand. Your agent reads this file only when SKILL.md points to it.

query-address-info — CLI Reference

Complete reference for every command in scripts/cli.mjs.

Invocation pattern: node <skill-dir>/scripts/cli.mjs <command> '<json_params>' Exit codes: 0 success · 1 usage/upstream error · 3 network failure

positions — Wallet active-position list

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

Parameters

Param Type Required Description
address string yes Wallet address (EVM 0x... or Solana base58)
chainId string yes "56" (BSC) · "8453" (Base) · "CT_501" (Solana)
offset number yes Pagination offset (start from 0)

Return fields (under .data.list[])

Field Type Description
chainId string Chain identifier
address string Queried wallet address (lowercased)
contractAddress string Token contract address
binanceTokenId string Binance-internal stable token ID
name, symbol string Token display names
icon string Logo path — prefix with https://bin.bnbstatic.com
decimals number Token decimals
price string Current USD price (decimal string)
percentChange24h string 24h price change (%, signed decimal string)
baseCoinPrice string USD price of the chain native coin
remainQty string Holding quantity (human-readable, already divided by decimals)
circulatingSupply string Circulating supply
riskLevel, riskLevelInt string | null, number Risk badge ("LOW" = 1, etc.); may be null
lowLiquidity number 1 = low-liquidity warning

Response envelope (under .data)

Field Type Description
offset number Echo of request offset
list array | null Position list; null when wallet has no tracked holdings
addressStatus any Reserved (currently always null)

Errors

Exit codes: 0 ok · 1 upstream/usage (stderr: reason; stdout: body with business code) · 3 network. Business code: 000000 ok · 100004 rate-limited · 100002 bad param · 000400 unsupported chain / bad address.

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.