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
- Project 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
Supported Chains
| Chain Name | chainId |
|---|
| BSC | 56 |
| Base |
8453 |
| Solana | CT_501 |
API 1: Token Search
Method: GET
URL:
CODEBLOCK0
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:
CODEBLOCK1
Example Request:
CODEBLOCK2
Response Example:
CODEBLOCK3
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:
CODEBLOCK4
Request Parameters:
| Parameter | Type | Required | Description |
|---|
| chainId | string | Yes | Chain ID |
| contractAddress |
string | Yes | Token contract address |
Request Headers:
CODEBLOCK5
Example Request:
CODEBLOCK6
Response Example:
CODEBLOCK7
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:
CODEBLOCK8
Request Parameters:
| Parameter | Type | Required | Description |
|---|
| chainId | string | Yes | Chain ID |
| contractAddress |
string | Yes | Token contract address |
Request Headers:
CODEBLOCK9
Example Request:
CODEBLOCK10
Response Example:
CODEBLOCK11
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:
CODEBLOCK12
Request Parameters:
| Parameter | Type | Required | Description |
|---|
| address | string | Yes | Token contract address |
| platform |
string | Yes | Chain platform:
eth,
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 | eth |
| BSC |
bsc |
| Solana | solana |
| Base | base |
Request Headers:
CODEBLOCK13
Example Request:
CODEBLOCK14
Response Example:
CODEBLOCK15
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 |
Notes
- 1. Icon URL requires full domain prefix:
https://bin.bnbstatic.com + icon path - All numeric fields are string format, convert when using
- Dynamic data updates in real-time, suitable for market display
- K-Line API uses
platform (eth/bsc/solana/base) instead of chainId, and limit takes priority over from when both are provided - K-Line response is a 2D array (not JSON objects) — parse by index: [open, high, low, close, volume, timestamp, count]
查询代币信息技能
概述
| API | 功能 | 使用场景 |
|---|
| 代币搜索 | 搜索代币 | 按名称、符号或合约地址查找代币 |
| 代币元数据 |
静态信息 | 获取代币详情、名称、符号、图标、社交链接、创建者地址 |
| 代币动态数据 | 实时市场数据 | 价格、成交量、持有者、流动性、市值 |
| 代币K线 | 蜡烛图 | 用于技术分析的OHLCV数据 |
使用场景
- 1. 搜索代币：跨链按名称、符号或合约地址查找代币
- 项目研究：获取代币元数据、社交链接和创建者信息
- 市场分析：实时价格、成交量、持有者分布和流动性数据
- 图表分析：用于技术分析的K线蜡烛图数据
支持的链
8453 |
| Solana | CT_501 |
API 1：代币搜索
方法：GET
URL：
https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|
| keyword | string | 是 | 搜索关键词（名称/符号/合约地址） |
| chainIds |
string | 否 | 链ID列表，逗号分隔，例如 56,8453,CT_501 |
| orderBy | string | 否 | 排序字段，例如 volume24h |
请求头：
Accept-Encoding: identity
示例请求：
bash
curl --location https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search?keyword=xxx&chainIds=56,8453,CT_501&orderBy=volume24h \
--header Accept-Encoding: identity
响应示例：
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
}
响应字段：
| 字段 | 类型 | 描述 |
|---|
| chainId | string | 链ID |
| contractAddress |
string | 合约地址 |
| tokenId | string | 代币唯一ID |
| name | string | 代币名称 |
| symbol | string | 代币符号 |
| icon | string | 图标URL路径 |
| price | string | 当前价格（美元） |
| percentChange24h | string | 24小时价格变化（%） |
| volume24h | string | 24小时交易量（美元） |
| marketCap | string | 市值（美元） |
| liquidity | string | 流动性（美元） |
| tagsInfo | object | 标签信息 |
| links | array | 社交链接列表 |
| createTime | number | 创建时间戳（毫秒） |
| holdersTop10Percent | string | 前10持有者占比（%） |
API 2：代币元数据
方法：GET
URL：
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|
| chainId | string | 是 | 链ID |
| contractAddress |
string | 是 | 代币合约地址 |
请求头：
Accept-Encoding: identity
示例请求：
bash
curl --location https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955 \
--header Accept-Encoding: identity
响应示例：
json
{
code: 000000,
data: {
tokenId: CC1F457B,
name: name of Token,
symbol: symbol of token,
chainId: 56,
chainIconUrl: https://bin.bnbstatic.com/image/adminmgsimage_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
}
响应字段：
| 字段 | 类型 | 描述 |
|---|
| tokenId | string | 代币唯一ID |
| name |
string | 代币名称 |
| symbol | string | 代币符号 |
| chainId | string | 链ID |
| chainName | string | 链名称 |
| contractAddress | string | 合约地址 |
| decimals | number | 代币精度 |
| icon | string | 图标URL路径 |
| links | array | 社交链接列表 |
| createTime | number | 创建时间戳（毫秒） |
| creatorAddress | string | 创建者地址 |
| description | string | 代币描述 |
API 3：代币动态数据
方法：GET
URL：
https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|
| chainId | string | 是 | 链ID |
| contractAddress |
string | 是 | 代币合约地址 |
请求头：
Accept-Encoding: identity
示例请求：
bash
curl --location https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955 \
--header Accept-Encoding: identity
响应示例：
json
{
code: 000000,
data: {
price: 48.00617218672732466029,
nativeTokenPrice: 589.09115969567768209591,
