Query Address Info

Query Address Info

Retrieves all token balances and on-chain positions for any wallet address

Category: development Source: binance/binance-skills-hub

What Is This?

Overview

Query Address Info is a development skill that retrieves on-chain wallet data for any specified blockchain address. It pulls token balances, asset positions, and portfolio details directly from the blockchain, giving developers and analysts immediate access to wallet holdings without manual chain exploration. The skill is part of the Binance Skills Hub and is maintained by the Binance Web3 team.

The skill returns structured data for each token held in a wallet, including the token name, symbol, current price, 24-hour price change percentage, and the quantity held. This combination of balance data and market context makes it useful for building dashboards, monitoring tools, and portfolio trackers. It works across multiple chains, allowing a single integration point for cross-chain wallet analysis.

Developers integrating this skill into their workflows can query any public wallet address without requiring private keys or wallet authentication. The read-only nature of the skill makes it safe to use in automated pipelines, reporting tools, and user-facing applications where wallet data needs to be displayed or analyzed.

Who Should Use This

  • Blockchain developers building portfolio tracking applications or wallet dashboards
  • DeFi analysts who need to audit wallet positions across multiple chains
  • Backend engineers integrating on-chain data into financial reporting systems
  • QA engineers verifying token balances during smart contract testing workflows
  • Data engineers building pipelines that aggregate on-chain wallet metrics
  • Product teams prototyping Web3 features that require live wallet balance data

Why Use It?

Problems It Solves

  • Eliminates the need to manually query multiple blockchain explorers to gather token holdings for a single address
  • Removes the complexity of parsing raw RPC responses when retrieving ERC-20 or native token balances
  • Provides market price context alongside balance data, removing the need for a separate price feed integration
  • Reduces development time when building cross-chain portfolio features by offering a unified query interface
  • Avoids the overhead of maintaining custom indexers or subgraphs just to read wallet token positions

Core Highlights

  • Retrieves all token holdings for a specified wallet address in a single call
  • Returns token name, symbol, price, 24-hour price change, and holding quantity per token
  • Supports multiple blockchain networks through a single skill interface
  • Read-only access requires no private keys or wallet signatures
  • Structured response format simplifies downstream data processing
  • Maintained by the Binance Web3 team with versioned releases for stability
  • Compatible with development workflows that use the Binance Skills Hub ecosystem

How to Use It?

Basic Usage

To query a wallet address, invoke the skill with the target address and the chain identifier. The following example shows a basic call structure:

{
  "skill": "query-address-info",
  "params": {
    "address": "0xYourWalletAddressHere",
    "chain": "ethereum"
  }
}

The response returns an array of token objects, each containing balance and price information:

{
  "tokens": [
    {
      "name": "USD Coin",
      "symbol": "USDC",
      "price": 1.00,
      "price_change_24h": 0.01,
      "quantity": 500.00
    }
  ]
}

Specific Scenarios

Portfolio Snapshot: A developer building a wallet dashboard calls the skill on page load, passing the connected wallet address and selected chain. The returned token list populates a holdings table with live prices and quantities.

Cross-Chain Balance Audit: An analyst queries the same wallet address across Ethereum, BNB Chain, and Polygon by making three separate calls with different chain parameters, then aggregates the results to produce a full cross-chain portfolio report.

Real-World Examples

DeFi Risk Monitoring: A risk team queries high-value wallet addresses daily to track large token position changes. The 24-hour price change field flags significant value shifts that may indicate liquidation risk.

Onboarding Flow Verification: A Web3 application queries a new user's wallet address during onboarding to display their existing token holdings, personalizing the experience without requiring manual input.

When to Use It?

Use Cases

  • Building wallet portfolio dashboards for Web3 applications
  • Auditing token holdings for compliance or risk assessment workflows
  • Populating user profile pages with live asset data
  • Monitoring whale wallets for large position changes
  • Verifying test wallet balances during smart contract development
  • Generating on-chain portfolio reports for financial analysis
  • Powering chatbot responses when users ask about wallet balances or asset positions

Important Notes

Requirements

  • A valid public wallet address in the correct format for the target chain
  • A supported chain identifier recognized by the Binance Skills Hub
  • Network connectivity to the Binance Skills Hub API endpoint
  • Skill version 1.1 or later for full token metadata support