--- id: sm-query-token-info name: "query-token-info" url: https://skills.yangsir.net/skill/sm-query-token-info author: binance domain: web3 tags: ["token-data", "blockchain-apis", "binance-smart-chain", "erc-20"] install_count: 4700 rating: 4.40 (20 reviews) github: https://github.com/binance/binance-skills-hub --- # query-token-info > 查询代币信息，支持按名称、符号或合约地址搜索代币，并获取代币元数据。 **Stats**: 4,700 installs · 4.4/5 (20 reviews) ## Before / After 对比 ### 区块链代币信息查询对比 ## Readme # 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.4KRepository[binance/binance…ills-hub](https://github.com/binance/binance-skills-hub)GitHub Stars473First SeenMar 2, 2026Security Audits[Gen Agent Trust HubPass](/binance/binance-skills-hub/query-token-info/security/agent-trust-hub)[SocketPass](/binance/binance-skills-hub/query-token-info/security/socket)[SnykWarn](/binance/binance-skills-hub/query-token-info/security/snyk)Installed oncodex1.3Kopencode1.3Kcursor1.3Kgemini-cli1.3Kamp1.3Kgithub-copilot1.3K --- *Source: https://skills.yangsir.net/skill/sm-query-token-info* *Markdown mirror: https://skills.yangsir.net/api/skill/sm-query-token-info/markdown*