query-token-info
binance/binance-skills-hub
Search tokens and fetch real-time price, metadata, and candlestick data across Ethereum, BSC, Base, and Solana.
What is query-token-info?
Query token information by keyword, symbol, or contract address. Retrieve static metadata (name, logo, social links, creator), real-time market data (price, volume, holders, liquidity), and OHLCV candlestick charts for technical analysis across four major blockchains.
- Search tokens by keyword, symbol, or contract address across multiple chains
- Fetch static token metadata including name, symbol, logo, social links, and creator info
- Get real-time market data: price, 24h change, volume, holder count, and liquidity
- Retrieve OHLCV candlestick data for technical analysis with customizable intervals and time windows
How to install query-token-info
npx skills add https://github.com/binance/binance-skills-hub --skill query-token-info- Node.js installed
- Access to Binance token data APIs
How to use query-token-info
- 1.Install the skill using: npx skills add https://github.com/binance/binance-skills-hub --skill query-token-info
- 2.Use the search command to find tokens: node <skill-dir>/scripts/cli.mjs search '{"keyword":"<token-name>","chainIds":"56"}'
- 3.Call meta command with chainId and contractAddress to get token metadata
- 4.Call dynamic command with chainId and contractAddress to fetch real-time market data
- 5.Call kline command with chainId, contractAddress, and interval to get candlestick data for charting
Use cases
- Find token contract addresses and basic info by searching for token name or symbol
- Monitor real-time token prices and 24-hour trading volume for market analysis
- Analyze token price movements using candlestick charts with intervals from 1 second to 1 month
- Research token creators and social media links for due diligence
- Track holder distribution and liquidity metrics for token evaluation
- Crypto traders and investors researching tokens
- DeFi analysts performing technical and fundamental analysis
- Token discovery and due diligence workflows
- Market monitoring and price tracking applications
query-token-info FAQ
Ethereum (chainId: 1), BSC (56), Base (8453), and Solana (CT_501).
Prepend https://bin.bnbstatic.com to the relative icon path returned by the API.
All numeric market fields (price, volume, marketCap, etc.) are returned as strings and must be converted before arithmetic operations.
Supported intervals are: 1s, 1min, 3min, 5min, 15min, 30min, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1m.
The limit parameter takes priority over from when both are provided. Use limit with to to fetch the N most recent candles ending at a specific timestamp.
Full instructions (SKILL.md)
Source of truth, from binance/binance-skills-hub.
name: query-token-info description: | Per-token details for a specific token identified by keyword, symbol, or contract address: (1) search — find tokens by keyword/symbol/contract; (2) meta — static info: name, symbol, logo, social links, creator, official website; (3) dynamic — real-time market data: price, 24h change, volume, holder count, liquidity; (4) kline — OHLCV candlestick data for technical analysis. Use for: "price of $X", "search for token Y", "kline chart for $Z", "who created $W", "social links for $V", "holder count of $U", "candlestick data", "find the contract address of <token>". metadata: author: binance-web3-team version: "2.0"
Query Token Info Skill
Overview
Four read-only token endpoints fronted by one CLI. The agent picks a subcommand and passes a JSON blob; with this skill user can:
Search Tokens: Find tokens by name, symbol, or contract address across chains. Token Research: Get token metadata, social links, and creator info. Market Analysis: Real-time price, volume, holder distribution, and liquidity data. Chart Analysis: K-Line candlestick data for technical analysis.
When to Use This Skill
| User intent | Command |
|---|---|
| Search a token by keyword, symbol, or contract address | search |
| Get static metadata (name, symbol, logo, social links, creator) | meta |
| Get real-time market data (price, volume, holders, liquidity) | dynamic |
| Get candlestick chart / OHLCV data | kline |
Supported Chains
| Chain | chainId |
|---|---|
| Ethereum | 1 |
| BSC | 56 |
| Base | 8453 |
| Solana | CT_501 |
All four commands (search, meta, dynamic, kline) use the same chainId values.
How to Call APIs
node <skill-dir>/scripts/cli.mjs <command> '<json_params>'
Example:
node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'
Commands
| Command | Purpose | Required args | Example |
|---|---|---|---|
search | Search tokens by keyword | keyword (optional: chainIds, orderBy) | node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"1,56,8453,CT_501"}' |
meta | Static token metadata | chainId, contractAddress | node <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}' |
dynamic | Real-time market data | chainId, contractAddress | node <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}' |
kline | Candlestick data | chainId, contractAddress, interval (optional: limit, from, to, pm) | node <skill-dir>/scripts/cli.mjs kline '{"chainId":"56","contractAddress":"0x...","interval":"1min","limit":500}' |
Rules
- Icon URL:
iconfields are relative paths. Prependhttps://bin.bnbstatic.comfor a usable URL. - Numbers as strings: All numeric market fields (
price,volume24h,marketCap, etc.) are returned as strings. Convert before arithmetic. - Kline is a 2D array, not JSON objects. Each candle:
[open, high, low, close, volume, timestamp_ms, count]. - Kline time window:
limittakes priority overfromwhen both are provided. Usetowithlimitto fetch the N most recent candles ending atto.pmselects price (p, default) or market-cap (m) series. - Intervals supported by
kline:1s,1min,3min,5min,15min,30min,1h,2h,4h,6h,8h,12h,1d,3d,1w,1m.
Full CLI Reference
See references/cli.md for per-subcommand invocations, parameter tables, return-field tables, and real response samples.
Related skills
More from binance/binance-skills-hub and the wider catalog.
simple-earn
Manage Binance Simple Earn products and BFUSD/RWUSD accounts via authenticated API.
spot
Execute authenticated Binance Spot API requests for trading, market data, and order management.
square-post
Publish text, images, articles, and videos to Binance Square with a single command.
sub-account
Manage Binance sub-accounts via API: create, enable features, transfer assets, and monitor positions.
trading-signal
Track smart-money buy/sell signals on BSC and Solana with trigger prices, max gains, and exit rates.
vip-loan
Request and manage VIP loans on Binance with authenticated API endpoints.