query-address-info

Retrieve token balances and position details for on-chain wallet addresses.

957|244|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/tradecatlabs/tradecat-public --skill query-address-info-tradecatlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query-address-info
Source: https://github.com/tradecatlabs/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/tradecatlabs/tradecat-public --skill query-address-info-tradecatlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Wallet balance and portfolio questions are hard to answer accurately without manually checking on-chain token positions and market context for each holding.

Core Features & Use Cases

  • On-chain wallet holdings lookup: Retrieves all token holdings for a specified wallet address on a given chain, including contract address, token name, and symbol.
  • Market context per holding: Returns current token price (USD) and 24h percent change for each token.
  • Position sizing details: Provides holding quantity (remainQty) and token decimals for portfolio breakdowns.
  • Use cases: Use it to answer “What tokens does this address hold?”, “How is the address portfolio performing today?”, or “What assets are in this wallet right now?”

Quick Start

Ask the assistant: “Query token balances for wallet 0x0000000000000000000000000000000000000001 on chain 56.”

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 token balances for a wallet address on-chain?

To check on-chain token balances, query a wallet address on a specific blockchain network to retrieve token holdings, including contract addresses, symbols, and remainQty. This returns all tokens held in the wallet along with current market prices.

What information is included in an on-chain wallet portfolio snapshot?

An on-chain wallet portfolio snapshot includes token names, symbols, contract addresses, holding quantities (remainQty), token decimals, current USD prices, and 24h percent changes. This provides a complete breakdown of all assets held at the queried address.

Can I retrieve token balances and 24h price changes for a wallet on Solana or Base?

Yes, you can retrieve token balances and 24h price changes for a wallet on Solana, Base, or BSC. The query requires a valid wallet address and the corresponding chainId to fetch all supported token positions and market data.

How do I troubleshoot asset allocation issues in a blockchain wallet?

To troubleshoot asset allocation issues, fetch all token positions for the wallet address to verify remainQty and token decimals across the portfolio. This reveals exactly which tokens are held and their current quantities to identify missing or unexpected assets.

What parameters are required to fetch wallet token holdings?

The required parameters to fetch wallet token holdings are the wallet address, the chainId specifying the blockchain network, and an offset value. These are submitted via a GET request to retrieve the corresponding token balances and position details.

What are the limitations of using a basic wallet address query for portfolio tracking?

A basic wallet address query provides a static snapshot of token balances and 24h price changes but does not offer continuous real-time monitoring, historical transaction logs, or automated alerts. It requires manual querying for each portfolio check.