币安查询代币信息API：搜索代币、获取元数据、实时价格、K线数据

query-token-info by binance/binance-skills-hub

1,800 周安装量

516 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/binance/binance-skills-hub --skill query-token-info

开发数据分析区块链

🇨🇳中文介绍

查询代币信息技能

概述

API	功能	使用场景
代币搜索	搜索代币	通过名称、符号或合约地址查找代币
代币元数据	静态信息	获取代币详情、名称、符号、图标、社交链接、创建者地址
代币动态数据	实时市场数据	价格、交易量、持有者、流动性、市值
代币K线	K线图	用于技术分析的OHLCV数据

使用场景

搜索代币 : 跨链通过名称、符号或合约地址查找代币
项目研究 : 获取代币元数据、社交链接和创建者信息
市场分析 : 实时价格、交易量、持有者分布和流动性数据
图表分析 : 用于技术分析的K线数据

支持的链

链名称	chainId

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

参数	类型	必需	描述
keyword	string	是	搜索关键词（名称/符号/合约地址）
chainIds	string	否	链ID列表，逗号分隔，例如 `56,8453,CT_501`
orderBy	string	否	排序字段，例如 `volume24h`

字段	类型	描述
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: 代币元数据

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
User-Agent: binance-web3/1.0 (Skill)

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' \
--header 'User-Agent: binance-web3/1.0 (Skill)'

{
    "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
}

字段	类型	描述
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: 代币动态数据

https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info

参数	类型	必需	描述
chainId	string	是	链ID
contractAddress	string	是	代币合约地址

Accept-Encoding: identity
User-Agent: binance-web3/1.0 (Skill)

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' \
--header 'User-Agent: binance-web3/1.0 (Skill)'

{
    "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	string	当前价格（美元）
nativeTokenPrice	string	原生代币价格
priceHigh24h	string	24小时最高价
priceLow24h	string	24小时最低价

字段	类型	描述
percentChange5m	string	5分钟价格变化（%）
percentChange1h	string	1小时价格变化（%）
percentChange4h	string	4小时价格变化（%）
percentChange24h	string	24小时价格变化（%）

字段	类型	描述
volume24h	string	24小时总交易量（美元）
volume24hBuy	string	24小时买入交易量
volume24hSell	string	24小时卖出交易量
volume4h	string	4小时交易量
volume1h	string	1小时交易量
volume5m	string	5分钟交易量

字段	类型	描述
count24h	string	24小时交易笔数
count24hBuy	string	24小时买入笔数
count24hSell	string	24小时卖出笔数

字段	类型	描述
marketCap	string	市值（美元）
fdv	string	完全稀释估值
totalSupply	string	总供应量
circulatingSupply	string	流通供应量
liquidity	string	流动性（美元）

字段	类型	描述
holders	string	总持有者数量
top10HoldersPercentage	string	前10名持有者占比（%）
kycHolderCount	string	KYC持有者数量
kolHolders	string	KOL持有者数量
kolHoldingPercent	string	KOL持有占比
devHoldingPercent	string	开发者持有占比
proHoldingPercent	string	专业投资者持有占比
smartMoneyHoldingPercent	string	聪明钱持有占比

https://dquery.sintral.io/u-kline/v1/k-line/candles

参数	类型	必需	描述
address	string	是	代币合约地址
platform	string	是	链平台：`ethereum`, `bsc`, `solana`, `base`
interval	string	是	K线间隔（见下方间隔参考）
limit	number	否	返回的K线数量（优先级高于 `from`）
from	number	否	开始时间戳（毫秒）
to	number	否	结束时间戳（毫秒）
pm	string	否	K线类型：`p` 表示价格，`m` 表示市值（默认：`p`）

间隔	描述
1s	1秒
1min	1分钟
3min	3分钟
5min	5分钟
15min	15分钟
30min	30分钟
1h	1小时
2h	2小时
4h	4小时
6h	6小时
8h	8小时
12h	12小时
1d	1天
3d	3天
1w	1周
1m	1个月

链	platform 值
Ethereum	ethereum
BSC	bsc
Solana	solana
Base	base

Accept-Encoding: identity
User-Agent: binance-web3/1.0 (Skill)

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.0 (Skill)'

{
    "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	open	number	开盘价
1	high	number	最高价
2	low	number	最低价
3	close	number	收盘价
4	volume	number	交易量
5	timestamp	number	K线时间戳（毫秒）
6	count	number	交易笔数

包含 User-Agent 头，使用以下字符串：binance-web3/1.0 (Skill)

图标URL需要完整域名前缀：https://bin.bnbstatic.com + 图标路径
所有数字字段均为字符串格式，使用时需转换
动态数据实时更新，适合市场展示
K线API使用 platform（eth/bsc/solana/base）而非 chainId，且当同时提供 limit 和 from 时，limit 优先级更高
K线响应是一个二维数组（非JSON对象）— 按索引解析：[open, high, low, close, volume, timestamp, count]

🇺🇸English

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

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 :

https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search

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.0 (Skill)

Example Request :

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' \
--header 'User-Agent: binance-web3/1.0 (Skill)'

Response Example :

{
    "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

API 2: Token Metadata

Method: GET

URL :

https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info

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.0 (Skill)

Example Request :

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' \
--header 'User-Agent: binance-web3/1.0 (Skill)'

Response Example :

{
    "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)

API 3: Token Dynamic Data

Method: GET

URL :

https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info

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.0 (Skill)

Example Request :

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' \
--header 'User-Agent: binance-web3/1.0 (Skill)'

Response Example :

{
    "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`)

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

Platform Mapping :

Chain	platform value
Ethereum	ethereum
BSC	bsc
Solana	solana
Base	base

Request Headers :

Accept-Encoding: identity
User-Agent: binance-web3/1.0 (Skill)

Example Request :

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.0 (Skill)'

Response Example :

{
    "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.0 (Skill)

Notes

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]

Weekly Installs

518

Repository

binance/binance…ills-hub

GitHub Stars

366

First Seen

8 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex499

gemini-cli498

amp498

github-copilot498

opencode498

cursor498

币安查询代币信息API：搜索代币、获取元数据、实时价格、K线数据

🇨🇳中文介绍

查询代币信息技能

概述

使用场景

支持的链

相关 Skills

API 1: 代币搜索

方法: GET

API 2: 代币元数据

方法: GET

API 3: 代币动态数据

方法: GET

价格相关

价格变化

交易量

交易笔数

市场数据

持有者数据

API 4: 代币K线

方法: GET

用户代理头

注意事项

🇺🇸English

Query Token Info Skill

Overview

Use Cases

Supported Chains

API 1: Token Search

Method: GET

API 2: Token Metadata

Method: GET

API 3: Token Dynamic Data

Method: GET

Price Related

Price Change

Volume

Transaction Count

Market Data

Holder Data

API 4: Token K-Line (Candlestick)

Method: GET

User Agent Header

Notes