query-token-info

Query token details, market data, and candlestick charts across BSC, Base, and Solana. Search tokens by name, symbol, or contract address; retrieve metadata including social links, creator info, and token descriptions Access real-time market data: price, 24-hour volume, market cap, liquidity, holder distribution, and price trends across multiple timeframes Fetch K-Line candlestick data with configurable intervals (1 second to 1 month) for technical analysis, supporting both price and market cap modes Supports three chains: BSC (chainId 56), Base (8453), and Solana (CT_501)

INSTALLATION
npx skills add https://github.com/binance/binance-skills-hub --skill query-token-info
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

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

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

Example Request:

curl --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' \

--header 'Accept-Encoding: identity' \

--header 'User-Agent: binance-web3/1.1 (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/ai

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

Example Request:

curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \

--header 'Accept-Encoding: identity' \

--header 'User-Agent: binance-web3/1.1 (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/ai

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

Example Request:

curl --location 'https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info/ai?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \

--header 'Accept-Encoding: identity' \

--header 'User-Agent: binance-web3/1.1 (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.1 (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.1 (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.1 (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]
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card