Back to Details

query-token-info

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Query Token Info Skill

查询代币信息Skill

Overview

概述

APIFunctionUse Case
Token SearchSearch tokensFind tokens by name, symbol, or contract address
Token MetadataStatic infoGet token details,name,symbol,logo, social links, creator address
Token Dynamic DataReal-time market dataPrice, volume, holders, liquidity, market cap
Token K-LineCandlestick chartsOHLCV data for technical analysis
API功能使用场景
Token Search搜索代币通过名称、符号或合约地址查找代币
Token Metadata静态信息查询获取代币详情，包含名称、符号、logo、社交链接、创建者地址
Token Dynamic Data实时市场数据查询获取价格、交易量、持有者数量、流动性、市值数据
Token K-Line蜡烛图查询获取用于技术分析的OHLCV数据

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
  1. 搜索代币：跨链通过名称、符号或合约地址查找代币
  2. 项目研究：获取代币元数据、社交链接和创建者信息
  3. 市场分析：获取实时价格、交易量、持有者分布和流动性数据
  4. 图表分析：获取用于技术分析的K线蜡烛图数据

Supported Chains

支持的链

Chain NamechainId
BSC56
Base8453
SolanaCT_501
链名称chainId
BSC56
Base8453
SolanaCT_501

API 1: Token Search

API 1: 代币搜索

Method: GET

请求方法: GET

URL:
https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search
Request Parameters:
ParameterTypeRequiredDescription
keywordstringYesSearch keyword (name/symbol/contract address)
chainIdsstringNoChain ID list, comma-separated, e.g., 
56,8453,CT_501
orderBystringNoSort field, e.g., 
volume24h
Request Headers:
Accept-Encoding: identity
Example Request:
bash
curl --location 'https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search?keyword=koge&chainIds=56,8453,CT_501&orderBy=volume24h' \
--header 'Accept-Encoding: identity'
Response Example:
json
{
    "code": "000000",
    "data": [
        {
            "chainId": "56",
            "contractAddress": "0xe6df05ce8c8301223373cf5b969afcb1498c5528",
            "tokenId": "CC1F457B32142B93198987B7FC893B26",
            "name": "48 Club Token",
            "symbol": "KOGE",
            "icon": "/images/web3-data/public/token/logos/CC1F457B32142B93198987B7FC893B26.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.48.club/"},
                {"label": "x", "link": "https://twitter.com/48Club_Official"}
            ],
            "createTime": 1600611727000,
            "holdersTop10Percent": "93.267178480644823",
            "riskLevel": null
        }
    ],
    "success": true
}
Response Fields:
FieldTypeDescription
chainIdstringChain ID
contractAddressstringContract address
tokenIdstringToken unique ID
namestringToken name
symbolstringToken symbol
iconstringIcon URL path
pricestringCurrent price (USD)
percentChange24hstring24-hour price change (%)
volume24hstring24-hour trading volume (USD)
marketCapstringMarket cap (USD)
liquiditystringLiquidity (USD)
tagsInfoobjectTag information
linksarraySocial links list
createTimenumberCreation timestamp (ms)
holdersTop10PercentstringTop 10 holders percentage (%)
请求URL:
https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search
请求参数:
参数类型必填描述
keywordstring是搜索关键词（名称/符号/合约地址）
chainIdsstring否链ID列表，逗号分隔，例如：
56,8453,CT_501
orderBystring否排序字段，例如：
volume24h
请求头:
Accept-Encoding: identity
请求示例:
bash
curl --location 'https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search?keyword=koge&chainIds=56,8453,CT_501&orderBy=volume24h' \
--header 'Accept-Encoding: identity'
响应示例:
json
{
    "code": "000000",
    "data": [
        {
            "chainId": "56",
            "contractAddress": "0xe6df05ce8c8301223373cf5b969afcb1498c5528",
            "tokenId": "CC1F457B32142B93198987B7FC893B26",
            "name": "48 Club Token",
            "symbol": "KOGE",
            "icon": "/images/web3-data/public/token/logos/CC1F457B32142B93198987B7FC893B26.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.48.club/"},
                {"label": "x", "link": "https://twitter.com/48Club_Official"}
            ],
            "createTime": 1600611727000,
            "holdersTop10Percent": "93.267178480644823",
            "riskLevel": null
        }
    ],
    "success": true
}
响应字段:
字段类型描述
chainIdstring链ID
contractAddressstring合约地址
tokenIdstring代币唯一ID
namestring代币名称
symbolstring代币符号
iconstring图标URL路径
pricestring当前价格（美元）
percentChange24hstring24小时价格涨跌幅（%）
volume24hstring24小时交易量（美元）
marketCapstring市值（美元）
liquiditystring流动性（美元）
tagsInfoobject标签信息
linksarray社交链接列表
createTimenumber创建时间戳（毫秒）
holdersTop10Percentstring前10大持有者占比（%）

API 2: Token Metadata

API 2: 代币元数据

Method: GET

请求方法: GET

URL:
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info
Request Parameters:
ParameterTypeRequiredDescription
chainIdstringYesChain ID
contractAddressstringYesToken contract address
Request Headers:
Accept-Encoding: identity
Example Request:
bash
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info?chainId=56&contractAddress=0xe6df05ce8c8301223373cf5b969afcb1498c5528' \
--header 'Accept-Encoding: identity'
Response Example:
json
{
    "code": "000000",
    "data": {
        "tokenId": "CC1F457B32142B93198987B7FC893B26",
        "name": "48 Club Token",
        "symbol": "KOGE",
        "chainId": "56",
        "chainIconUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/d0216ce4-a3e9-4bda-8937-4a6aa943ccf2.png",
        "chainName": "BSC",
        "contractAddress": "0xe6df05ce8c8301223373cf5b969afcb1498c5528",
        "decimals": 18,
        "icon": "/images/web3-data/public/token/logos/CC1F457B32142B93198987B7FC893B26.png",
        "nativeAddressFlag": false,
        "aiNarrativeFlag": 1,
        "links": [
            {"label": "website", "link": "https://www.48.club/"},
            {"label": "whitepaper", "link": "https://drive.google.com/file/d/..."},
            {"label": "x", "link": "https://twitter.com/48Club_Official"}
        ],
        "previewLink": {
            "website": ["https://www.48.club/"],
            "x": ["https://twitter.com/48Club_Official"],
            "tg": []
        },
        "createTime": 1600611727000,
        "creatorAddress": "0xa044d502c7e23840dcd5997fb3ba85a6de5763e4",
        "auditInfo": {
            "isBlacklist": false,
            "isWhitelist": true
        },
        "description": "48 Club Token (KOGE) is a cryptocurrency and operates on the BNB Smart Chain..."
    },
    "success": true
}
Response Fields:
FieldTypeDescription
tokenIdstringToken unique ID
namestringToken name
symbolstringToken symbol
chainIdstringChain ID
chainNamestringChain name
contractAddressstringContract address
decimalsnumberToken decimals
iconstringIcon URL path
linksarraySocial links list
createTimenumberCreation timestamp (ms)
creatorAddressstringCreator address
descriptionstringToken description
请求URL:
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info
请求参数:
参数类型必填描述
chainIdstring是链ID
contractAddressstring是代币合约地址
请求头:
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=0xe6df05ce8c8301223373cf5b969afcb1498c5528' \
--header 'Accept-Encoding: identity'
响应示例:
json
{
    "code": "000000",
    "data": {
        "tokenId": "CC1F457B32142B93198987B7FC893B26",
        "name": "48 Club Token",
        "symbol": "KOGE",
        "chainId": "56",
        "chainIconUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/d0216ce4-a3e9-4bda-8937-4a6aa943ccf2.png",
        "chainName": "BSC",
        "contractAddress": "0xe6df05ce8c8301223373cf5b969afcb1498c5528",
        "decimals": 18,
        "icon": "/images/web3-data/public/token/logos/CC1F457B32142B93198987B7FC893B26.png",
        "nativeAddressFlag": false,
        "aiNarrativeFlag": 1,
        "links": [
            {"label": "website", "link": "https://www.48.club/"},
            {"label": "whitepaper", "link": "https://drive.google.com/file/d/..."},
            {"label": "x", "link": "https://twitter.com/48Club_Official"}
        ],
        "previewLink": {
            "website": ["https://www.48.club/"],
            "x": ["https://twitter.com/48Club_Official"],
            "tg": []
        },
        "createTime": 1600611727000,
        "creatorAddress": "0xa044d502c7e23840dcd5997fb3ba85a6de5763e4",
        "auditInfo": {
            "isBlacklist": false,
            "isWhitelist": true
        },
        "description": "48 Club Token (KOGE) is a cryptocurrency and operates on the BNB Smart Chain..."
    },
    "success": true
}
响应字段:
字段类型描述
tokenIdstring代币唯一ID
namestring代币名称
symbolstring代币符号
chainIdstring链ID
chainNamestring链名称
contractAddressstring合约地址
decimalsnumber代币小数位数
iconstring图标URL路径
linksarray社交链接列表
createTimenumber创建时间戳（毫秒）
creatorAddressstring创建者地址
descriptionstring代币描述

API 3: Token Dynamic Data

API 3: 代币动态数据

Method: GET

请求方法: GET

URL:
https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info
Request Parameters:
ParameterTypeRequiredDescription
chainIdstringYesChain ID
contractAddressstringYesToken contract address
Request Headers:
Accept-Encoding: identity
Example Request:
bash
curl --location 'https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info?chainId=56&contractAddress=0xe6df05ce8c8301223373cf5b969afcb1498c5528' \
--header 'Accept-Encoding: identity'
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:
请求URL:
https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info
请求参数:
参数类型必填描述
chainIdstring是链ID
contractAddressstring是代币合约地址
请求头:
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=0xe6df05ce8c8301223373cf5b969afcb1498c5528' \
--header 'Accept-Encoding: identity'
响应示例:
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
}
响应字段:

Price Related

价格相关

FieldTypeDescription
pricestringCurrent price (USD)
nativeTokenPricestringNative token price
priceHigh24hstring24-hour high price
priceLow24hstring24-hour low price
字段类型描述
pricestring当前价格（美元）
nativeTokenPricestring原生代币价格
priceHigh24hstring24小时最高价
priceLow24hstring24小时最低价

Price Change

价格涨跌幅

FieldTypeDescription
percentChange5mstring5-minute price change (%)
percentChange1hstring1-hour price change (%)
percentChange4hstring4-hour price change (%)
percentChange24hstring24-hour price change (%)
字段类型描述
percentChange5mstring5分钟价格涨跌幅（%）
percentChange1hstring1小时价格涨跌幅（%）
percentChange4hstring4小时价格涨跌幅（%）
percentChange24hstring24小时价格涨跌幅（%）

Volume

交易量

FieldTypeDescription
volume24hstring24-hour total volume (USD)
volume24hBuystring24-hour buy volume
volume24hSellstring24-hour sell volume
volume4hstring4-hour volume
volume1hstring1-hour volume
volume5mstring5-minute volume
字段类型描述
volume24hstring24小时总交易量（美元）
volume24hBuystring24小时买入交易量
volume24hSellstring24小时卖出交易量
volume4hstring4小时交易量
volume1hstring1小时交易量
volume5mstring5分钟交易量

Transaction Count

交易次数

FieldTypeDescription
count24hstring24-hour transaction count
count24hBuystring24-hour buy count
count24hSellstring24-hour sell count
字段类型描述
count24hstring24小时总交易次数
count24hBuystring24小时买入交易次数
count24hSellstring24小时卖出交易次数

Market Data

市场数据

FieldTypeDescription
marketCapstringMarket cap (USD)
fdvstringFully diluted valuation
totalSupplystringTotal supply
circulatingSupplystringCirculating supply
liquiditystringLiquidity (USD)
字段类型描述
marketCapstring市值（美元）
fdvstring完全稀释估值
totalSupplystring总发行量
circulatingSupplystring流通量
liquiditystring流动性（美元）

Holder Data

持有者数据

FieldTypeDescription
holdersstringTotal holder count
top10HoldersPercentagestringTop 10 holders percentage (%)
kycHolderCountstringKYC holder count
kolHoldersstringKOL holder count
kolHoldingPercentstringKOL holding percentage
devHoldingPercentstringDev holding percentage
proHoldingPercentstringProfessional investor holding percentage
smartMoneyHoldingPercentstringSmart money holding percentage
字段类型描述
holdersstring总持有者数量
top10HoldersPercentagestring前10大持有者占比（%）
kycHolderCountstring完成KYC的持有者数量
kolHoldersstringKOL持有者数量
kolHoldingPercentstringKOL持仓占比
devHoldingPercentstring开发团队持仓占比
proHoldingPercentstring专业投资者持仓占比
smartMoneyHoldingPercentstring聪明钱持仓占比

API 4: Token K-Line (Candlestick)

API 4: 代币K线（蜡烛图）

Method: GET

请求方法: GET

URL:
https://dquery.sintral.io/u-kline/v1/k-line/candles
Request Parameters:
ParameterTypeRequiredDescription
addressstringYesToken contract address
platformstringYesChain platform: 
eth
, 
bsc
, 
solana
, 
base
intervalstringYesKline interval (see Interval Reference below)
limitnumberNoNumber of candles to return (has higher priority than 
from
)
fromnumberNoStart timestamp in milliseconds
tonumberNoEnd timestamp in milliseconds
pmstringNoKline type: 
p
for price, 
m
for market cap (default: 
p
)
Interval Reference:
IntervalDescription
1s1 second
1min1 minute
3min3 minutes
5min5 minutes
15min15 minutes
30min30 minutes
1h1 hour
2h2 hours
4h4 hours
6h6 hours
8h8 hours
12h12 hours
1d1 day
3d3 days
1w1 week
1m1 month
Platform Mapping:
Chainplatform value
Ethereumeth
BSCbsc
Solanasolana
Basebase
Request Headers:
Accept-Encoding: identity
Example Request:
bash
curl --location 'https://dquery.sintral.io/u-kline/v1/k-line/candles?address=0x9eadbe35f3ee3bf3e28180070c429298a1b02f93&interval=1min&limit=500&platform=base&to=1772126280000' \
--header 'Accept-Encoding: identity'
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:
IndexFieldTypeDescription
0opennumberOpen price
1highnumberHigh price
2lownumberLow price
3closenumberClose price
4volumenumberTrading volume
5timestampnumberCandle timestamp (ms)
6countnumberTransaction count
请求URL:
https://dquery.sintral.io/u-kline/v1/k-line/candles
请求参数:
参数类型必填描述
addressstring是代币合约地址
platformstring是链平台：
eth
、
bsc
、
solana
、
base
intervalstring是K线时间粒度（参考下方粒度说明）
limitnumber否返回K线数量（优先级高于
from
参数）
fromnumber否起始时间戳（毫秒）
tonumber否结束时间戳（毫秒）
pmstring否K线类型：
p
代表价格，
m
代表市值（默认：
p
）
粒度说明:
粒度值描述
1s1秒
1min1分钟
3min3分钟
5min5分钟
15min15分钟
30min30分钟
1h1小时
2h2小时
4h4小时
6h6小时
8h8小时
12h12小时
1d1天
3d3天
1w1周
1m1个月
平台映射关系:
链platform参数值
Ethereumeth
BSCbsc
Solanasolana
Basebase
请求头:
Accept-Encoding: identity
请求示例:
bash
curl --location 'https://dquery.sintral.io/u-kline/v1/k-line/candles?address=0x9eadbe35f3ee3bf3e28180070c429298a1b02f93&interval=1min&limit=500&platform=base&to=1772126280000' \
--header 'Accept-Encoding: identity'
响应示例:
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
    }
}
响应字段:
每根K线为一个数组，按顺序包含7个元素：
索引字段类型描述
0开盘价number开盘价格
1最高价number最高价格
2最低价number最低价格
3收盘价number收盘价格
4交易量number交易量
5时间戳numberK线时间戳（毫秒）
6交易次数number对应时间段内交易次数

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]
  1. 图标URL需要拼接完整域名前缀：
    https://bin.bnbstatic.com
    + 图标路径
  2. 所有数值字段均为字符串格式，使用时需自行转换类型
  3. 动态数据为实时更新，适合用于市场行情展示
  4. K线API使用
    platform
    参数（eth/bsc/solana/base）而非
    chainId
    ，当
    limit
    和
    from
    同时提供时，
    limit
    优先级更高
  5. K线响应为二维数组（非JSON对象），需按索引解析：[开盘价, 最高价, 最低价, 收盘价, 交易量, 时间戳, 交易次数]