query-token-info
Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
Best use case
query-token-info is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
Teams using query-token-info should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/binance-official-web3-query-token-info/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How query-token-info Compares
| Feature / Agent | query-token-info | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Query Token Info Skill
## Overview
| API | Function | Use Case |
|-----|----------|----------|
| Token Search | Search tokens | Find tokens by name, symbol, or contract address |
| Token Metadata | Static info | Get token details,name,symbol,logo, social links, creator address |
| Token Dynamic Data | Real-time market data | Price, volume, holders, liquidity, market cap |
| Token K-Line | Candlestick charts | OHLCV data for technical analysis |
## Use Cases
1. **Search Tokens**: Find tokens by name, symbol, or contract address across chains
2. **Project Research**: Get token metadata, social links, and creator info
3. **Market Analysis**: Real-time price, volume, holder distribution, and liquidity data
4. **Chart Analysis**: K-Line candlestick data for technical analysis
## Supported Chains
| Chain Name | chainId |
|------------|---------|
| BSC | 56 |
| Base | 8453 |
| Solana | CT_501 |
---
## API 1: Token Search
### Method: GET
**URL**:
```
https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search/ai
```
**Request Parameters**:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| keyword | string | Yes | Search keyword (name/symbol/contract address) |
| chainIds | string | No | Chain ID list, comma-separated, e.g., `56,8453,CT_501` |
| orderBy | string | No | Sort field, e.g., `volume24h` |
**Request Headers**:
```
Accept-Encoding: identity
User-Agent: binance-web3/1.1 (Skill)
```
**Example Request**:
```bash
curl --location 'https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search/ai?keyword=xxx&chainIds=56,8453,CT_501&orderBy=volume24h' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)'
```
**Response Example**:
```json
{
"code": "000000",
"data": [
{
"chainId": "56",
"contractAddress": "0x1234...",
"tokenId": "CC1F457...",
"name": "Token",
"symbol": "symbol of token",
"icon": "/images/web3-data/public/token/logos/xxx.png",
"price": "47.98771375939603199404",
"percentChange24h": "-0.01",
"volume24h": "53687246.955803546359104902201",
"marketCap": "162198400",
"liquidity": "13388877.147327333572157",
"tokenAddresses": [...],
"tagsInfo": {
"AI Analysis": [{"tagName": "AI Widget", "languageKey": "wmp-label-title-ai-widget"}],
"Community Recognition Level": [{"tagName": "Alpha", "languageKey": "wmp-label-title-alpha"}]
},
"links": [
{"label": "website", "link": "https://www.web.site/"},
{"label": "x", "link": "https://twitter.com/..."}
],
"createTime": 1600611727000,
"holdersTop10Percent": "93.267178480644823",
"riskLevel": null
}
],
"success": true
}
```
**Response Fields**:
| Field | Type | Description |
|-------|------|-------------|
| chainId | string | Chain ID |
| contractAddress | string | Contract address |
| tokenId | string | Token unique ID |
| name | string | Token name |
| symbol | string | Token symbol |
| icon | string | Icon URL path |
| price | string | Current price (USD) |
| percentChange24h | string | 24-hour price change (%) |
| volume24h | string | 24-hour trading volume (USD) |
| marketCap | string | Market cap (USD) |
| liquidity | string | Liquidity (USD) |
| tagsInfo | object | Tag information |
| links | array | Social links list |
| createTime | number | Creation timestamp (ms) |
| holdersTop10Percent | string | Top 10 holders percentage (%) |
---
## API 2: Token Metadata
### Method: GET
**URL**:
```
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info/ai
```
**Request Parameters**:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| chainId | string | Yes | Chain ID |
| contractAddress | string | Yes | Token contract address |
**Request Headers**:
```
Accept-Encoding: identity
User-Agent: binance-web3/1.1 (Skill)
```
**Example Request**:
```bash
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)'
```
**Response Example**:
```json
{
"code": "000000",
"data": {
"tokenId": "CC1F457B",
"name": "name of Token",
"symbol": "symbol of token",
"chainId": "56",
"chainIconUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/d0216ce4-a3e9-4bda-8937-4a6aa943ccf2.png",
"chainName": "BSC",
"contractAddress": "0x55d398326f99059ff775485246999027b3197955",
"decimals": 18,
"icon": "/images/web3-data/public/token/logos/xxx.png",
"nativeAddressFlag": false,
"aiNarrativeFlag": 1,
"links": [
{"label": "website", "link": "https://www.web.site/"},
{"label": "whitepaper", "link": "https://drive.google.com/file/d/..."},
{"label": "x", "link": "https://twitter.com/..."}
],
"previewLink": {
"website": ["https://www.web.site/"],
"x": ["https://twitter.com/..."],
"tg": []
},
"createTime": 1600611727000,
"creatorAddress": "0x1234...",
"auditInfo": {
"isBlacklist": false,
"isWhitelist": true
},
"description": "this is a good token..."
},
"success": true
}
```
**Response Fields**:
| Field | Type | Description |
|-------|------|-------------|
| tokenId | string | Token unique ID |
| name | string | Token name |
| symbol | string | Token symbol |
| chainId | string | Chain ID |
| chainName | string | Chain name |
| contractAddress | string | Contract address |
| decimals | number | Token decimals |
| icon | string | Icon URL path |
| links | array | Social links list |
| createTime | number | Creation timestamp (ms) |
| creatorAddress | string | Creator address |
| description | string | Token description |
---
## API 3: Token Dynamic Data
### Method: GET
**URL**:
```
https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info/ai
```
**Request Parameters**:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| chainId | string | Yes | Chain ID |
| contractAddress | string | Yes | Token contract address |
**Request Headers**:
```
Accept-Encoding: identity
User-Agent: binance-web3/1.1 (Skill)
```
**Example Request**:
```bash
curl --location 'https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)'
```
**Response Example**:
```json
{
"code": "000000",
"data": {
"price": "48.00617218672732466029",
"nativeTokenPrice": "589.09115969567768209591",
"volume24h": "53803143.235015073706599196363",
"volume24hBuy": "26880240.472839229350983682189",
"volume24hSell": "26922902.762175844355615514174",
"volume4h": "7179919.170580971950485838372",
"volume1h": "3181854.878039371691111933489",
"volume5m": "84557.068962077549412188792",
"count24h": "39869",
"count24hBuy": "19850",
"count24hSell": "20019",
"percentChange5m": "0.03",
"percentChange1h": "0.02",
"percentChange4h": "0.03",
"percentChange24h": "0.01",
"marketCap": "162260777.94315716831842935701774977509483735135",
"totalSupply": "3379998.56",
"circulatingSupply": "3379998.249225519124584315",
"priceHigh24h": "48.59526604943723770716",
"priceLow24h": "47.4815509902145490401",
"holders": "78255",
"fdv": "162260792.8622504084644326891824",
"liquidity": "13393863.149264026822944",
"launchTime": 1600950241000,
"top10HoldersPercentage": "93.2621248736909194",
"kycHolderCount": "23579",
"kolHolders": "17",
"kolHoldingPercent": "0.000059",
"proHolders": "138",
"proHoldingPercent": "0.003357",
"smartMoneyHolders": "1",
"smartMoneyHoldingPercent": "0"
},
"success": true
}
```
**Response Fields**:
### Price Related
| Field | Type | Description |
|-------|------|-------------|
| price | string | Current price (USD) |
| nativeTokenPrice | string | Native token price |
| priceHigh24h | string | 24-hour high price |
| priceLow24h | string | 24-hour low price |
### Price Change
| Field | Type | Description |
|-------|------|-------------|
| percentChange5m | string | 5-minute price change (%) |
| percentChange1h | string | 1-hour price change (%) |
| percentChange4h | string | 4-hour price change (%) |
| percentChange24h | string | 24-hour price change (%) |
### Volume
| Field | Type | Description |
|-------|------|-------------|
| volume24h | string | 24-hour total volume (USD) |
| volume24hBuy | string | 24-hour buy volume |
| volume24hSell | string | 24-hour sell volume |
| volume4h | string | 4-hour volume |
| volume1h | string | 1-hour volume |
| volume5m | string | 5-minute volume |
### Transaction Count
| Field | Type | Description |
|-------|------|-------------|
| count24h | string | 24-hour transaction count |
| count24hBuy | string | 24-hour buy count |
| count24hSell | string | 24-hour sell count |
### Market Data
| Field | Type | Description |
|-------|------|-------------|
| marketCap | string | Market cap (USD) |
| fdv | string | Fully diluted valuation |
| totalSupply | string | Total supply |
| circulatingSupply | string | Circulating supply |
| liquidity | string | Liquidity (USD) |
### Holder Data
| Field | Type | Description |
|-------|------|-------------|
| holders | string | Total holder count |
| top10HoldersPercentage | string | Top 10 holders percentage (%) |
| kycHolderCount | string | KYC holder count |
| kolHolders | string | KOL holder count |
| kolHoldingPercent | string | KOL holding percentage |
| devHoldingPercent| string | Dev holding percentage |
| proHoldingPercent | string | Professional investor holding percentage |
| smartMoneyHoldingPercent | string | Smart money holding percentage |
---
## API 4: Token K-Line (Candlestick)
### Method: GET
**URL**:
```
https://dquery.sintral.io/u-kline/v1/k-line/candles
```
**Request Parameters**:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| address | string | Yes | Token contract address |
| platform | string | Yes | Chain platform: `ethereum`, `bsc`, `solana`, `base` |
| interval | string | Yes | Kline interval (see Interval Reference below) |
| limit | number | No | Number of candles to return (has higher priority than `from`) |
| from | number | No | Start timestamp in milliseconds |
| to | number | No | End timestamp in milliseconds |
| pm | string | No | Kline type: `p` for price, `m` for market cap (default: `p`) |
**Interval Reference**:
| Interval | Description |
|----------|-------------|
| 1s | 1 second |
| 1min | 1 minute |
| 3min | 3 minutes |
| 5min | 5 minutes |
| 15min | 15 minutes |
| 30min | 30 minutes |
| 1h | 1 hour |
| 2h | 2 hours |
| 4h | 4 hours |
| 6h | 6 hours |
| 8h | 8 hours |
| 12h | 12 hours |
| 1d | 1 day |
| 3d | 3 days |
| 1w | 1 week |
| 1m | 1 month |
**Platform Mapping**:
| Chain | platform value |
|-------|---------------|
| Ethereum | ethereum |
| BSC | bsc |
| Solana | solana |
| Base | base |
**Request Headers**:
```
Accept-Encoding: identity
User-Agent: binance-web3/1.1 (Skill)
```
**Example Request**:
```bash
curl --location 'https://dquery.sintral.io/u-kline/v1/k-line/candles?address=0x55d398326f99059ff775485246999027b3197955&interval=1min&limit=500&platform=bsc&to=1772126280000' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)'
```
**Response Example**:
```json
{
"data": [
[0.10779318, 0.10779318, 0.10778039, 0.10778039, 2554.06, 1772125800000, 3],
[0.10778039, 0.10781213, 0.10770104, 0.10770104, 2994.53, 1772125920000, 3],
[0.10770104, 0.10770104, 0.10769200, 0.10769200, 2825.65, 1772126040000, 3],
[0.10769200, 0.10777858, 0.10766827, 0.10777858, 2457.99, 1772126160000, 3],
[0.10777858, 0.10778521, 0.10764351, 0.10764351, 3106.87, 1772126280000, 4]
],
"status": {
"timestamp": "2026-02-28T05:52:25.717Z",
"error_code": "0",
"error_message": "SUCCESS",
"elapsed": "0",
"credit_count": 0
}
}
```
**Response Fields**:
Each candle is an array with 7 elements in order:
| Index | Field | Type | Description |
|-------|-------|------|-------------|
| 0 | open | number | Open price |
| 1 | high | number | High price |
| 2 | low | number | Low price |
| 3 | close | number | Close price |
| 4 | volume | number | Trading volume |
| 5 | timestamp | number | Candle timestamp (ms) |
| 6 | count | number | Transaction count |
---
## User Agent Header
Include `User-Agent` header with the following string: `binance-web3/1.1 (Skill)`
## Notes
1. Icon URL requires full domain prefix: `https://bin.bnbstatic.com` + icon path
2. All numeric fields are string format, convert when using
3. Dynamic data updates in real-time, suitable for market display
4. K-Line API uses `platform` (eth/bsc/solana/base) instead of `chainId`, and `limit` takes priority over `from` when both are provided
5. K-Line response is a 2D array (not JSON objects) — parse by index: [open, high, low, close, volume, timestamp, count]Related Skills
okx-dex-token
Use this skill for token-level data: cluster overview, search tokens, trending/hot tokens (热门, 代币榜单), liquidity pools, holder distribution (whale/巨鲸, sniper, bundler percent), token safety and honeypot risk (貔貅盘, 'is this token a honeypot', 'is this safe to buy', 'rugged?', 'can I sell this'), who created a token, recent buy/sell activity, top profit addresses, trade history by wallet type, or holder cluster analysis (持仓集中度, rug pull probability/跑路风险, new wallet percentage/新钱包持仓比例, suspicious holding percentage/可疑持仓%, bundle hold percent, holder clusters, 'are top holders in same cluster'). Invoke on user intent; address can be provided after. Do NOT use for market-wide whale/signal tracking — use okx-dex-signal. Do NOT use for meme/pump.fun launch scanning, dev reputation, or bundle detection — use okx-dex-trenches. Do NOT use for personal DEX trade history or price charts — use okx-dex-market.
gate-info-trendanalysis
Trend and technical analysis. Use this skill whenever the user asks for technical or trend analysis of one coin. Trigger phrases include: technical analysis, K-line, RSI, MACD, trend, support, resistance. MCP tools: info_markettrend_get_kline, info_markettrend_get_indicator_history, info_markettrend_get_technical_analysis, info_marketsnapshot_get_market_snapshot.
gate-info-riskcheck
Token and address risk assessment. Use this skill whenever the user asks about token, contract, or address safety. Trigger phrases include: is this token safe, check contract risk, is this address safe, honeypot, rug. MCP tools: info_compliance_check_token_security, info_coin_get_coin_info; Address mode: info_onchain_get_address_info.
gate-info-marketoverview
Market overview. Use this skill whenever the user asks about overall market. Trigger phrases include: how is the market, market overview, what is happening in crypto. MCP tools: info_marketsnapshot_get_market_overview, info_coin_get_coin_rankings, info_platformmetrics_get_defi_overview, news_events_get_latest_events, info_macro_get_macro_summary.
gate-info-coinanalysis
Coin comprehensive analysis. Use this skill whenever the user asks to analyze a single coin. Trigger phrases include: analyze, how is, worth buying, look at. MCP tools: info_coin_get_coin_info, info_marketsnapshot_get_market_snapshot, info_markettrend_get_technical_analysis, news_feed_search_news, news_feed_get_social_sentiment.
query-token-audit
Query token security audit to detect scams, honeypots, and malicious contracts before trading. Returns comprehensive security analysis including contract risks, trading risks, and scam detection. Use when users ask "is this token safe?", "check token security", "audit token", or before any swap.
query-address-info
Query any on-chain wallet address token balances and positions. Retrieves all token holdings for a specified wallet address on a given chain, including token name, symbol, price, 24h price change, and holding quantity. Use this skill when users ask about wallet balance, token holds, portfolio, or asset positions for any blockchain address.
tokr-tokenization-agent
Tokenization agent for the ERC-8004 ecosystem that automates token creation through on-chain feedback and matched token launches.
pay-with-any-token
Pay HTTP 402 payment challenges using tokens via the Tempo CLI and Uniswap Trading API. Use when the user encounters a 402 Payment Required response, needs to fulfill a machine payment, mentions "MPP", "Tempo payment", "pay for API access", "HTTP 402", "x402", "machine payment protocol", "pay-with-any-token", "use tempo", "tempo request", or "tempo wallet".
tokr-tokenization
Tokenization agent for ERC-8004 ecosystem automating token creation through on-chain feedback matching.
token-revoke-mcp
Check and revoke ERC-20 token allowances to secure wallets. Scan for risky unlimited approvals and generate revocation transactions.
rocketpool-tokens
Interact with Rocket Pool token contracts — RPL (governance/staking token) ERC-20 operations, inflation mechanics, old RPL swap, rocketVault balance queries, and L2 token addresses for rETH and RPL on Arbitrum, Optimism, Base, Polygon, zkSync Era, Scroll, Starknet, and Unichain. Supports cast (Foundry CLI) and Ethereum MCP tools on mainnet and Hoodi testnet.