Home/区块链与 Web3/query-token-info
Q

query-token-info

by @binancev
4.1(4)

Query token information, supporting search by name, symbol, or contract address, and retrieve token metadata.

Token DataBlockchain APIsBinance Smart ChainERC-20GitHub
Installation
npx skills add binance/binance-skills-hub --skill query-token-info
compare_arrows

Before / After Comparison

1 组
Before

When users need to query token information, they often have to switch between multiple platforms (e.g., CoinMarketCap, Etherscan), manually search for token names and contract addresses, and retrieve data such as price, market cap, and K-line charts. This process is fragmented and time-consuming.

After

With the token information query skill, users only need to provide the token name, symbol, or contract address to get all relevant information, including token metadata, real-time price, 24-hour change, and K-line data, through a unified interface. This significantly improves query efficiency and convenience.

description SKILL.md

query-token-info

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

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)

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

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)

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.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 Installs1.4KRepositorybinance/binance…ills-hubGitHub Stars473First SeenMar 2, 2026Security AuditsGen Agent Trust HubPassSocketPassSnykWarnInstalled oncodex1.3Kopencode1.3Kcursor1.3Kgemini-cli1.3Kamp1.3Kgithub-copilot1.3K

forumUser Reviews (0)

Write a Review

Effect
Usability
Docs
Compatibility

No reviews yet

Statistics

Installs217
Rating4.1 / 5.0
Version
Updated2026年3月17日
Comparisons1

User Rating

4.1(4)
5
0%
4
0%
3
0%
2
0%
1
0%

Rate this Skill

0.0

Compatible Platforms

🔧Claude Code
🔧OpenClaw
🔧OpenCode
🔧Codex
🔧Gemini CLI
🔧GitHub Copilot
🔧Amp
🔧Kimi CLI

Timeline

Created2026年3月17日
Last Updated2026年3月17日