query-address-info

Query wallet token balances and positions with market context for analysis.

957|244|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/tukuaiai/tradecat-public --skill query-address-info-tukuaiai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query-address-info
Source: https://github.com/tukuaiai/tradecat-public/tree/main/resources/agent_market_context/binance/upstream/binance-skills-hub-main/skills/binance-web3/query-address-info
Command: npx skills add https://github.com/tukuaiai/tradecat-public --skill query-address-info-tukuaiai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand what tokens a specific blockchain wallet holds and what those holdings are worth, without manually checking explorers one by one.

Core Features & Use Cases

  • Token balance lookup for any address: Retrieves the full list of token holdings for a provided wallet address and chain.
  • Market context per holding: Returns each token’s current price (USD) and 24h price change alongside the holding quantity.
  • Portfolio-style inspection: Use it to answer questions like “What assets does this address currently hold?” and “How did these tokens move in the last 24 hours?” for supported chains such as BSC and Base.

Quick Start

Ask: “Query wallet token balances and positions for address 0x0000000000000000000000000000000000000001 on chain 56, including token names, prices, 24h change, and remaining quantities.”

Frequently Asked Questions about query-address-info

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check a wallet's token balances and current prices on-chain?

To check wallet token balances and current prices on-chain, query a specific wallet address and chain ID to retrieve token names, symbols, USD prices, 24h price changes, and remaining quantities. This provides immediate market context for portfolio inspection.

Can I retrieve token holdings for a BSC or Base wallet address?

Yes, you can retrieve token holdings for a BSC or Base wallet address by providing the specific address and the corresponding supported chain ID. The query returns a paginated list of token balances, prices, and 24h percent changes.

How do I get paginated results when inspecting a large blockchain portfolio?

You get paginated results when inspecting a blockchain portfolio by applying an offset parameter to your wallet address query. This fetches subsequent pages of token holdings, ensuring you retrieve all remaining quantities and asset data without truncation.

What information is returned when I query an address for token positions?

Querying an address for token positions returns the token name, symbol, current USD price, 24h price change (percentChange24h), and remaining quantity (remainQty) for each asset held. This data supports asset distribution reviews and portfolio activity analysis.

Does wallet portfolio inspection require a specific chain ID to function?

Yes, wallet portfolio inspection requires a specific chain ID to function, alongside the target wallet address. Providing the correct chain ID ensures the query accurately fetches supported on-chain token balances and market context for that network.

Why does my token balance lookup only show a partial list of holdings?

Your token balance lookup shows a partial list of holdings because results are paginated. You must fetch additional pages using the offset parameter to retrieve the complete set of token names, prices, and remaining quantities across the wallet.