Query Token Info

What Is This?

Overview

Query Token Info is a development skill designed for retrieving comprehensive token data from blockchain networks. It enables developers and analysts to search for tokens by keyword, contract address, or chain identifier, and then pull structured metadata, social links, and real-time market statistics in a single workflow. The skill is built and maintained by the Binance Web3 team and integrates directly with live market infrastructure.

The skill covers a broad range of data points, including token price, price trend direction, trading volume, holder counts, liquidity depth, and K-Line candlestick chart data. Rather than querying multiple separate APIs or manually aggregating data from different sources, this skill consolidates token intelligence into one accessible interface. It is versioned at 1.1 and is part of the Binance Skills Hub ecosystem.

For development teams building Web3 applications, trading tools, or analytics dashboards, this skill provides a reliable foundation for token data retrieval. It reduces integration complexity and ensures that market data remains current, pulling from real-time feeds rather than cached or delayed sources.

Who Should Use This

• Web3 developers building decentralized applications that need to display token metadata or market statistics to end users
• Quantitative analysts who require structured candlestick data for backtesting or signal generation
• DeFi product teams integrating token search and price display features into wallets or portfolio trackers
• Data engineers constructing pipelines that aggregate on-chain token information across multiple networks
• Technical researchers investigating token liquidity, holder distribution, or social presence for due diligence
• AI agent developers embedding token lookup capabilities into conversational or automated trading assistants

Why Use It?

Problems It Solves

• Eliminates the need to maintain separate integrations for token metadata, price feeds, and chart data across different providers
• Removes manual effort in resolving token identity across chains, since the skill accepts keyword, contract address, or chain as input
• Reduces latency in development workflows by providing a single query interface instead of chaining multiple API calls
• Addresses the challenge of finding accurate social and project links alongside market data, which are often scattered across different registries
• Simplifies candlestick data retrieval, which typically requires specialized chart data APIs with separate authentication

Core Highlights

• Search tokens using flexible inputs: keyword, contract address, or chain identifier
• Retrieve structured token metadata including name, symbol, decimals, and contract details
• Access social links and project information alongside technical token data
• Query real-time price and price trend indicators
• Pull trading volume and liquidity depth metrics
• Retrieve holder count statistics for token distribution analysis
• Fetch K-Line candlestick chart data for technical analysis workflows
• Compatible with multi-chain environments through chain-specific query parameters

How to Use It?

Basic Usage

A basic token search by keyword returns metadata and current market data for matching tokens.

from binance_skills_hub import QueryTokenInfo

client = QueryTokenInfo()

result = client.search(keyword="PEPE", chain="ETH")
print(result["price"])
print(result["volume_24h"])
print(result["holders"])

To query by contract address directly:

result = client.search(
    contract_address="0x6982508145454Ce325dDbE47a25d4ec3d2311933",
    chain="ETH"
)
print(result["metadata"])
print(result["social_links"])

Specific Scenarios

Scenario 1: Fetching K-Line Data for Chart Rendering

When building a price chart component, retrieve candlestick data with a specified interval and limit.

kline_data = client.get_kline(
    contract_address="0x6982508145454Ce325dDbE47a25d4ec3d2311933",
    chain="ETH",
    interval="1h",
    limit=100
)
for candle in kline_data:
    print(candle["open"], candle["close"], candle["high"], candle["low"])

Scenario 2: Monitoring Liquidity and Holder Trends

For risk assessment workflows, query liquidity and holder counts at regular intervals to detect unusual changes.

stats = client.get_market_stats(contract_address="0x...", chain="BSC")
print(stats["liquidity_usd"])
print(stats["holder_count"])

Real-World Examples

• A portfolio tracker application uses keyword search to resolve user-entered token names into verified contract addresses before displaying balances.
• A trading bot queries real-time price trend data every 60 seconds to determine entry and exit conditions.
• A research dashboard pulls holder counts and liquidity metrics weekly to track token health over time.

When to Use It?

Use Cases

• Building token search functionality in a Web3 wallet or exchange interface
• Generating price alerts based on real-time market data feeds
• Constructing technical analysis charts using candlestick data
• Auditing token liquidity and holder distribution for investment research
• Populating token metadata in a DeFi aggregator or comparison tool
• Automating token discovery workflows in AI-powered trading assistants
• Validating contract addresses and retrieving associated project information

Important Notes

Requirements

• Valid API credentials from Binance Skills Hub are required for authenticated requests
• Chain identifiers must match supported network codes such as ETH, BSC, or SOL
• Contract addresses must be checksummed and correctly formatted for the target chain