1---
2name: query-token-info
3description: |
4  Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links,
5  retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts.
6  Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
7metadata:
8  author: binance-web3-team
9  version: "1.1"
10---
11 
12# Query Token Info Skill
13 
14## Overview
15 
16| API | Function | Use Case |
17|-----|----------|----------|
18| Token Search | Search tokens | Find tokens by name, symbol, or contract address |
19| Token Metadata | Static info | Get token details,name,symbol,logo, social links, creator address |
20| Token Dynamic Data | Real-time market data | Price, volume, holders, liquidity, market cap |
21| Token K-Line | Candlestick charts | OHLCV data for technical analysis |
22 
23## Use Cases
24 
251. **Search Tokens**: Find tokens by name, symbol, or contract address across chains
262. **Project Research**: Get token metadata, social links, and creator info
273. **Market Analysis**: Real-time price, volume, holder distribution, and liquidity data
284. **Chart Analysis**: K-Line candlestick data for technical analysis
29 
30## Supported Chains
31 
32| Chain Name | chainId |
33|------------|---------|
34| BSC | 56 |
35| Base | 8453 |
36| Solana | CT_501 |
37 
38---
39 
40## API 1: Token Search
41 
42### Method: GET
43 
44**URL**: 
45```
46https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search/ai
47```
48 
49**Request Parameters**:
50 
51| Parameter | Type | Required | Description |
52|-----------|------|----------|-------------|
53| keyword | string | Yes | Search keyword (name/symbol/contract address) |
54| chainIds | string | No | Chain ID list, comma-separated, e.g., `56,8453,CT_501` |
55| orderBy | string | No | Sort field, e.g., `volume24h` |
56 
57**Request Headers**:
58```
59Accept-Encoding: identity
60User-Agent: binance-web3/1.1 (Skill)
61```
62 
63**Example Request**:
64```bash
65curl --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' \
66--header 'Accept-Encoding: identity' \
67--header 'User-Agent: binance-web3/1.1 (Skill)'
68```
69 
70**Response Example**:
71```json
72{
73    "code": "000000",
74    "data": [
75        {
76            "chainId": "56",
77            "contractAddress": "0x1234...",
78            "tokenId": "CC1F457...",
79            "name": "Token",
80            "symbol": "symbol of token",
81            "icon": "/images/web3-data/public/token/logos/xxx.png",
82            "price": "47.98771375939603199404",
83            "percentChange24h": "-0.01",
84            "volume24h": "53687246.955803546359104902201",
85            "marketCap": "162198400",
86            "liquidity": "13388877.147327333572157",
87            "tokenAddresses": [...],
88            "tagsInfo": {
89                "AI Analysis": [{"tagName": "AI Widget", "languageKey": "wmp-label-title-ai-widget"}],
90                "Community Recognition Level": [{"tagName": "Alpha", "languageKey": "wmp-label-title-alpha"}]
91            },
92            "links": [
93                {"label": "website", "link": "https://www.web.site/"},
94                {"label": "x", "link": "https://twitter.com/..."}
95            ],
96            "createTime": 1600611727000,
97            "holdersTop10Percent": "93.267178480644823",
98            "riskLevel": null
99        }
100    ],
101    "success": true
102}
103```
104 
105**Response Fields**:
106 
107| Field | Type | Description |
108|-------|------|-------------|
109| chainId | string | Chain ID |
110| contractAddress | string | Contract address |
111| tokenId | string | Token unique ID |
112| name | string | Token name |
113| symbol | string | Token symbol |
114| icon | string | Icon URL path |
115| price | string | Current price (USD) |
116| percentChange24h | string | 24-hour price change (%) |
117| volume24h | string | 24-hour trading volume (USD) |
118| marketCap | string | Market cap (USD) |
119| liquidity | string | Liquidity (USD) |
120| tagsInfo | object | Tag information |
121| links | array | Social links list |
122| createTime | number | Creation timestamp (ms) |
123| holdersTop10Percent | string | Top 10 holders percentage (%) |
124 
125---
126 
127## API 2: Token Metadata
128 
129### Method: GET
130 
131**URL**: 
132```
133https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info/ai
134```
135 
136**Request Parameters**:
137 
138| Parameter | Type | Required | Description |
139|-----------|------|----------|-------------|
140| chainId | string | Yes | Chain ID |
141| contractAddress | string | Yes | Token contract address |
142 
143**Request Headers**:
144```
145Accept-Encoding: identity
146User-Agent: binance-web3/1.1 (Skill)
147```
148 
149**Example Request**:
150```bash
151curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \
152--header 'Accept-Encoding: identity' \
153--header 'User-Agent: binance-web3/1.1 (Skill)'
154```
155 
156**Response Example**:
157```json
158{
159    "code": "000000",
160    "data": {
161        "tokenId": "CC1F457B",
162        "name": "name of Token",
163        "symbol": "symbol of token",
164        "chainId": "56",
165        "chainIconUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/d0216ce4-a3e9-4bda-8937-4a6aa943ccf2.png",
166        "chainName": "BSC",
167        "contractAddress": "0x55d398326f99059ff775485246999027b3197955",
168        "decimals": 18,
169        "icon": "/images/web3-data/public/token/logos/xxx.png",
170        "nativeAddressFlag": false,
171        "aiNarrativeFlag": 1,
172        "links": [
173            {"label": "website", "link": "https://www.web.site/"},
174            {"label": "whitepaper", "link": "https://drive.google.com/file/d/..."},
175            {"label": "x", "link": "https://twitter.com/..."}
176        ],
177        "previewLink": {
178            "website": ["https://www.web.site/"],
179            "x": ["https://twitter.com/..."],
180            "tg": []
181        },
182        "createTime": 1600611727000,
183        "creatorAddress": "0x1234...",
184        "auditInfo": {
185            "isBlacklist": false,
186            "isWhitelist": true
187        },
188        "description": "this is a good token..."
189    },
190    "success": true
191}
192```
193 
194**Response Fields**:
195 
196| Field | Type | Description |
197|-------|------|-------------|
198| tokenId | string | Token unique ID |
199| name | string | Token name |
200| symbol | string | Token symbol |
201| chainId | string | Chain ID |
202| chainName | string | Chain name |
203| contractAddress | string | Contract address |
204| decimals | number | Token decimals |
205| icon | string | Icon URL path |
206| links | array | Social links list |
207| createTime | number | Creation timestamp (ms) |
208| creatorAddress | string | Creator address |
209| description | string | Token description |
210 
211---
212 
213## API 3: Token Dynamic Data
214 
215### Method: GET
216 
217**URL**: 
218```
219https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info/ai
220```
221 
222**Request Parameters**:
223 
224| Parameter | Type | Required | Description |
225|-----------|------|----------|-------------|
226| chainId | string | Yes | Chain ID |
227| contractAddress | string | Yes | Token contract address |
228 
229**Request Headers**:
230```
231Accept-Encoding: identity
232User-Agent: binance-web3/1.1 (Skill)
233```
234 
235**Example Request**:
236```bash
237curl --location 'https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \
238--header 'Accept-Encoding: identity' \
239--header 'User-Agent: binance-web3/1.1 (Skill)'
240```
241 
242**Response Example**:
243```json
244{
245    "code": "000000",
246    "data": {
247        "price": "48.00617218672732466029",
248        "nativeTokenPrice": "589.09115969567768209591",
249        "volume24h": "53803143.235015073706599196363",
250        "volume24hBuy": "26880240.472839229350983682189",
251        "volume24hSell": "26922902.762175844355615514174",
252        "volume4h": "7179919.170580971950485838372",
253        "volume1h": "3181854.878039371691111933489",
254        "volume5m": "84557.068962077549412188792",
255        "count24h": "39869",
256        "count24hBuy": "19850",
257        "count24hSell": "20019",
258        "percentChange5m": "0.03",
259        "percentChange1h": "0.02",
260        "percentChange4h": "0.03",
261        "percentChange24h": "0.01",
262        "marketCap": "162260777.94315716831842935701774977509483735135",
263        "totalSupply": "3379998.56",
264        "circulatingSupply": "3379998.249225519124584315",
265        "priceHigh24h": "48.59526604943723770716",
266        "priceLow24h": "47.4815509902145490401",
267        "holders": "78255",
268        "fdv": "162260792.8622504084644326891824",
269        "liquidity": "13393863.149264026822944",
270        "launchTime": 1600950241000,
271        "top10HoldersPercentage": "93.2621248736909194",
272        "kycHolderCount": "23579",
273        "kolHolders": "17",
274        "kolHoldingPercent": "0.000059",
275        "proHolders": "138",
276        "proHoldingPercent": "0.003357",
277        "smartMoneyHolders": "1",
278        "smartMoneyHoldingPercent": "0"
279    },
280    "success": true
281}
282```
283 
284**Response Fields**:
285 
286### Price Related
287| Field | Type | Description |
288|-------|------|-------------|
289| price | string | Current price (USD) |
290| nativeTokenPrice | string | Native token price |
291| priceHigh24h | string | 24-hour high price |
292| priceLow24h | string | 24-hour low price |
293 
294### Price Change
295| Field | Type | Description |
296|-------|------|-------------|
297| percentChange5m | string | 5-minute price change (%) |
298| percentChange1h | string | 1-hour price change (%) |
299| percentChange4h | string | 4-hour price change (%) |
300| percentChange24h | string | 24-hour price change (%) |
301 
302### Volume
303| Field | Type | Description |
304|-------|------|-------------|
305| volume24h | string | 24-hour total volume (USD) |
306| volume24hBuy | string | 24-hour buy volume |
307| volume24hSell | string | 24-hour sell volume |
308| volume4h | string | 4-hour volume |
309| volume1h | string | 1-hour volume |
310| volume5m | string | 5-minute volume |
311 
312### Transaction Count
313| Field | Type | Description |
314|-------|------|-------------|
315| count24h | string | 24-hour transaction count |
316| count24hBuy | string | 24-hour buy count |
317| count24hSell | string | 24-hour sell count |
318 
319### Market Data
320| Field | Type | Description |
321|-------|------|-------------|
322| marketCap | string | Market cap (USD) |
323| fdv | string | Fully diluted valuation |
324| totalSupply | string | Total supply |
325| circulatingSupply | string | Circulating supply |
326| liquidity | string | Liquidity (USD) |
327 
328### Holder Data
329| Field | Type | Description |
330|-------|------|-------------|
331| holders | string | Total holder count |
332| top10HoldersPercentage | string | Top 10 holders percentage (%) |
333| kycHolderCount | string | KYC holder count |
334| kolHolders | string | KOL holder count |
335| kolHoldingPercent | string | KOL holding percentage |
336| devHoldingPercent| string | Dev holding percentage |
337| proHoldingPercent | string | Professional investor holding percentage |
338| smartMoneyHoldingPercent | string | Smart money holding percentage |
339 
340---
341 
342## API 4: Token K-Line (Candlestick)
343 
344### Method: GET
345 
346**URL**:
347```
348https://dquery.sintral.io/u-kline/v1/k-line/candles
349```
350 
351**Request Parameters**:
352 
353| Parameter | Type | Required | Description |
354|-----------|------|----------|-------------|
355| address | string | Yes | Token contract address |
356| platform | string | Yes | Chain platform: `ethereum`, `bsc`, `solana`, `base` |
357| interval | string | Yes | Kline interval (see Interval Reference below) |
358| limit | number | No | Number of candles to return (has higher priority than `from`) |
359| from | number | No | Start timestamp in milliseconds |
360| to | number | No | End timestamp in milliseconds |
361| pm | string | No | Kline type: `p` for price, `m` for market cap (default: `p`) |
362 
363**Interval Reference**:
364 
365| Interval | Description |
366|----------|-------------|
367| 1s | 1 second |
368| 1min | 1 minute |
369| 3min | 3 minutes |
370| 5min | 5 minutes |
371| 15min | 15 minutes |
372| 30min | 30 minutes |
373| 1h | 1 hour |
374| 2h | 2 hours |
375| 4h | 4 hours |
376| 6h | 6 hours |
377| 8h | 8 hours |
378| 12h | 12 hours |
379| 1d | 1 day |
380| 3d | 3 days |
381| 1w | 1 week |
382| 1m | 1 month |
383 
384**Platform Mapping**:
385 
386| Chain | platform value |
387|-------|---------------|
388| Ethereum | ethereum |
389| BSC | bsc |
390| Solana | solana |
391| Base | base |
392 
393**Request Headers**:
394```
395Accept-Encoding: identity
396User-Agent: binance-web3/1.1 (Skill)
397```
398 
399**Example Request**:
400```bash
401curl --location 'https://dquery.sintral.io/u-kline/v1/k-line/candles?address=0x55d398326f99059ff775485246999027b3197955&interval=1min&limit=500&platform=bsc&to=1772126280000' \
402--header 'Accept-Encoding: identity' \
403--header 'User-Agent: binance-web3/1.1 (Skill)'
404```
405 
406**Response Example**:
407```json
408{
409    "data": [
410        [0.10779318, 0.10779318, 0.10778039, 0.10778039, 2554.06, 1772125800000, 3],
411        [0.10778039, 0.10781213, 0.10770104, 0.10770104, 2994.53, 1772125920000, 3],
412        [0.10770104, 0.10770104, 0.10769200, 0.10769200, 2825.65, 1772126040000, 3],
413        [0.10769200, 0.10777858, 0.10766827, 0.10777858, 2457.99, 1772126160000, 3],
414        [0.10777858, 0.10778521, 0.10764351, 0.10764351, 3106.87, 1772126280000, 4]
415    ],
416    "status": {
417        "timestamp": "2026-02-28T05:52:25.717Z",
418        "error_code": "0",
419        "error_message": "SUCCESS",
420        "elapsed": "0",
421        "credit_count": 0
422    }
423}
424```
425 
426**Response Fields**:
427 
428Each candle is an array with 7 elements in order:
429 
430| Index | Field | Type | Description |
431|-------|-------|------|-------------|
432| 0 | open | number | Open price |
433| 1 | high | number | High price |
434| 2 | low | number | Low price |
435| 3 | close | number | Close price |
436| 4 | volume | number | Trading volume |
437| 5 | timestamp | number | Candle timestamp (ms) |
438| 6 | count | number | Transaction count |
439 
440---
441 
442## User Agent Header
443 
444Include `User-Agent` header with the following string: `binance-web3/1.1 (Skill)`
445 
446## Notes
447 
4481. Icon URL requires full domain prefix: `https://bin.bnbstatic.com` + icon path
4492. All numeric fields are string format, convert when using
4503. Dynamic data updates in real-time, suitable for market display
4514. K-Line API uses `platform` (eth/bsc/solana/base) instead of `chainId`, and `limit` takes priority over `from` when both are provided
4525. K-Line response is a 2D array (not JSON objects) — parse by index: [open, high, low, close, volume, timestamp, count]
453