mcpField
Q
query-address-info

query-address-info

github.com/binanceOther1.1k8.0k installsUpdated 2d ago
Repository

About query-address-info

A CLI-backed skill that lists the tokens held by a wallet and reports each token's current price, 24-hour price change, and quantity. It is for agents checking on-chain wallet positions across Ethereum, BSC, Solana, and Base.

Key features

  1. 01List tokens held by a wallet
  2. 02Show current token prices
  3. 03Report 24-hour price changes
  4. 04Return holding quantities with pagination

Use cases

  1. 01Review a wallet's token positions
  2. 02Check token prices and daily changes for holdings

Install

Copy the command and run it in a terminal.

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

After installing, type/query-address-infoin Claude Code to confirm it loaded.

Bundled filesreferences/cli.mdscripts/cli.mjs

Details

From the project README

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

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

Comments

Markdown supported