Agent Skill · Binance

query-token-info

Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.

View SKILL.md on GitHub → Source repository Provider profile
Provider: Binance Path in repo: skills/binance-web3/query-token-info/SKILL.md

Skill body

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

Supported Chains

Chain Name chainId
BSC 56
Base 8453
Solana CT_501

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:

| 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

  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]

Skill frontmatter

metadata: {"author"=>"binance-web3-team", "version"=>"1.1"}