功能描述

Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend,...

使用说明 (SKILL.md)

\r \r

Query Token Info Skill\r

Name: Binance Query Token
Author: viktor-huang

\r

Overview\r

\r | API | Function | Use Case |\r |-----|----------|----------|\r | Token Search | Search tokens | Find tokens by name, symbol, or contract address |\r | Token Metadata | Static info | Get token details,name,symbol,logo, social links, creator address |\r | Token Dynamic Data | Real-time market data | Price, volume, holders, liquidity, market cap |\r | Token K-Line | Candlestick charts | OHLCV data for technical analysis |\r \r

Use Cases\r

\r

Search Tokens: Find tokens by name, symbol, or contract address across chains\r
Project Research: Get token metadata, social links, and creator info\r
Market Analysis: Real-time price, volume, holder distribution, and liquidity data\r
Chart Analysis: K-Line candlestick data for technical analysis\r \r

Supported Chains\r

\r | Chain Name | chainId |\r |------------|---------|\r | BSC | 56 |\r | Base | 8453 |\r | Solana | CT_501 |\r \r ---\r \r

API 1: Token Search\r

\r

Method: GET\r

\r URL: \r

https://web3.binance.com/bapi/defi/v5/public/wallet-direct/buw/wallet/market/token/search\r
```\r
\r
**Request Parameters**:\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| keyword | string | Yes | Search keyword (name/symbol/contract address) |\r
| chainIds | string | No | Chain ID list, comma-separated, e.g., `56,8453,CT_501` |\r
| orderBy | string | No | Sort field, e.g., `volume24h` |\r
\r
**Request Headers**:\r
```\r
Accept-Encoding: identity\r
```\r
\r
**Example Request**:\r
```bash\r
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' \\r
--header 'Accept-Encoding: identity'\r
```\r
\r
**Response Example**:\r
```json\r
{\r
    "code": "000000",\r
    "data": [\r
        {\r
            "chainId": "56",\r
            "contractAddress": "0x1234...",\r
            "tokenId": "CC1F457...",\r
            "name": "Token",\r
            "symbol": "symbol of token",\r
            "icon": "/images/web3-data/public/token/logos/xxx.png",\r
            "price": "47.98771375939603199404",\r
            "percentChange24h": "-0.01",\r
            "volume24h": "53687246.955803546359104902201",\r
            "marketCap": "162198400",\r
            "liquidity": "13388877.147327333572157",\r
            "tokenAddresses": [...],\r
            "tagsInfo": {\r
                "AI Analysis": [{"tagName": "AI Widget", "languageKey": "wmp-label-title-ai-widget"}],\r
                "Community Recognition Level": [{"tagName": "Alpha", "languageKey": "wmp-label-title-alpha"}]\r
            },\r
            "links": [\r
                {"label": "website", "link": "https://www.web.site/"},\r
                {"label": "x", "link": "https://twitter.com/..."}\r
            ],\r
            "createTime": 1600611727000,\r
            "holdersTop10Percent": "93.267178480644823",\r
            "riskLevel": null\r
        }\r
    ],\r
    "success": true\r
}\r
```\r
\r
**Response Fields**:\r
\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| chainId | string | Chain ID |\r
| contractAddress | string | Contract address |\r
| tokenId | string | Token unique ID |\r
| name | string | Token name |\r
| symbol | string | Token symbol |\r
| icon | string | Icon URL path |\r
| price | string | Current price (USD) |\r
| percentChange24h | string | 24-hour price change (%) |\r
| volume24h | string | 24-hour trading volume (USD) |\r
| marketCap | string | Market cap (USD) |\r
| liquidity | string | Liquidity (USD) |\r
| tagsInfo | object | Tag information |\r
| links | array | Social links list |\r
| createTime | number | Creation timestamp (ms) |\r
| holdersTop10Percent | string | Top 10 holders percentage (%) |\r
\r
---\r
\r
## API 2: Token Metadata\r
\r
### Method: GET\r
\r
**URL**: \r
```\r
https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info\r
```\r
\r
**Request Parameters**:\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| chainId | string | Yes | Chain ID |\r
| contractAddress | string | Yes | Token contract address |\r
\r
**Request Headers**:\r
```\r
Accept-Encoding: identity\r
```\r
\r
**Example Request**:\r
```bash\r
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/meta/info?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \\r
--header 'Accept-Encoding: identity'\r
```\r
\r
**Response Example**:\r
```json\r
{\r
    "code": "000000",\r
    "data": {\r
        "tokenId": "CC1F457B",\r
        "name": "name of Token",\r
        "symbol": "symbol of token",\r
        "chainId": "56",\r
        "chainIconUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250228/d0216ce4-a3e9-4bda-8937-4a6aa943ccf2.png",\r
        "chainName": "BSC",\r
        "contractAddress": "0x55d398326f99059ff775485246999027b3197955",\r
        "decimals": 18,\r
        "icon": "/images/web3-data/public/token/logos/xxx.png",\r
        "nativeAddressFlag": false,\r
        "aiNarrativeFlag": 1,\r
        "links": [\r
            {"label": "website", "link": "https://www.web.site/"},\r
            {"label": "whitepaper", "link": "https://drive.google.com/file/d/..."},\r
            {"label": "x", "link": "https://twitter.com/..."}\r
        ],\r
        "previewLink": {\r
            "website": ["https://www.web.site/"],\r
            "x": ["https://twitter.com/..."],\r
            "tg": []\r
        },\r
        "createTime": 1600611727000,\r
        "creatorAddress": "0x1234...",\r
        "auditInfo": {\r
            "isBlacklist": false,\r
            "isWhitelist": true\r
        },\r
        "description": "this is a good token..."\r
    },\r
    "success": true\r
}\r
```\r
\r
**Response Fields**:\r
\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| tokenId | string | Token unique ID |\r
| name | string | Token name |\r
| symbol | string | Token symbol |\r
| chainId | string | Chain ID |\r
| chainName | string | Chain name |\r
| contractAddress | string | Contract address |\r
| decimals | number | Token decimals |\r
| icon | string | Icon URL path |\r
| links | array | Social links list |\r
| createTime | number | Creation timestamp (ms) |\r
| creatorAddress | string | Creator address |\r
| description | string | Token description |\r
\r
---\r
\r
## API 3: Token Dynamic Data\r
\r
### Method: GET\r
\r
**URL**: \r
```\r
https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info\r
```\r
\r
**Request Parameters**:\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| chainId | string | Yes | Chain ID |\r
| contractAddress | string | Yes | Token contract address |\r
\r
**Request Headers**:\r
```\r
Accept-Encoding: identity\r
```\r
\r
**Example Request**:\r
```bash\r
curl --location 'https://web3.binance.com/bapi/defi/v4/public/wallet-direct/buw/wallet/market/token/dynamic/info?chainId=56&contractAddress=0x55d398326f99059ff775485246999027b3197955' \\r
--header 'Accept-Encoding: identity'\r
```\r
\r
**Response Example**:\r
```json\r
{\r
    "code": "000000",\r
    "data": {\r
        "price": "48.00617218672732466029",\r
        "nativeTokenPrice": "589.09115969567768209591",\r
        "volume24h": "53803143.235015073706599196363",\r
        "volume24hBuy": "26880240.472839229350983682189",\r
        "volume24hSell": "26922902.762175844355615514174",\r
        "volume4h": "7179919.170580971950485838372",\r
        "volume1h": "3181854.878039371691111933489",\r
        "volume5m": "84557.068962077549412188792",\r
        "count24h": "39869",\r
        "count24hBuy": "19850",\r
        "count24hSell": "20019",\r
        "percentChange5m": "0.03",\r
        "percentChange1h": "0.02",\r
        "percentChange4h": "0.03",\r
        "percentChange24h": "0.01",\r
        "marketCap": "162260777.94315716831842935701774977509483735135",\r
        "totalSupply": "3379998.56",\r
        "circulatingSupply": "3379998.249225519124584315",\r
        "priceHigh24h": "48.59526604943723770716",\r
        "priceLow24h": "47.4815509902145490401",\r
        "holders": "78255",\r
        "fdv": "162260792.8622504084644326891824",\r
        "liquidity": "13393863.149264026822944",\r
        "launchTime": 1600950241000,\r
        "top10HoldersPercentage": "93.2621248736909194",\r
        "kycHolderCount": "23579",\r
        "kolHolders": "17",\r
        "kolHoldingPercent": "0.000059",\r
        "proHolders": "138",\r
        "proHoldingPercent": "0.003357",\r
        "smartMoneyHolders": "1",\r
        "smartMoneyHoldingPercent": "0"\r
    },\r
    "success": true\r
}\r
```\r
\r
**Response Fields**:\r
\r
### Price Related\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| price | string | Current price (USD) |\r
| nativeTokenPrice | string | Native token price |\r
| priceHigh24h | string | 24-hour high price |\r
| priceLow24h | string | 24-hour low price |\r
\r
### Price Change\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| percentChange5m | string | 5-minute price change (%) |\r
| percentChange1h | string | 1-hour price change (%) |\r
| percentChange4h | string | 4-hour price change (%) |\r
| percentChange24h | string | 24-hour price change (%) |\r
\r
### Volume\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| volume24h | string | 24-hour total volume (USD) |\r
| volume24hBuy | string | 24-hour buy volume |\r
| volume24hSell | string | 24-hour sell volume |\r
| volume4h | string | 4-hour volume |\r
| volume1h | string | 1-hour volume |\r
| volume5m | string | 5-minute volume |\r
\r
### Transaction Count\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| count24h | string | 24-hour transaction count |\r
| count24hBuy | string | 24-hour buy count |\r
| count24hSell | string | 24-hour sell count |\r
\r
### Market Data\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| marketCap | string | Market cap (USD) |\r
| fdv | string | Fully diluted valuation |\r
| totalSupply | string | Total supply |\r
| circulatingSupply | string | Circulating supply |\r
| liquidity | string | Liquidity (USD) |\r
\r
### Holder Data\r
| Field | Type | Description |\r
|-------|------|-------------|\r
| holders | string | Total holder count |\r
| top10HoldersPercentage | string | Top 10 holders percentage (%) |\r
| kycHolderCount | string | KYC holder count |\r
| kolHolders | string | KOL holder count |\r
| kolHoldingPercent | string | KOL holding percentage |\r
| devHoldingPercent| string | Dev holding percentage |\r
| proHoldingPercent | string | Professional investor holding percentage |\r
| smartMoneyHoldingPercent | string | Smart money holding percentage |\r
\r
---\r
\r
## API 4: Token K-Line (Candlestick)\r
\r
### Method: GET\r
\r
**URL**:\r
```\r
https://dquery.sintral.io/u-kline/v1/k-line/candles\r
```\r
\r
**Request Parameters**:\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| address | string | Yes | Token contract address |\r
| platform | string | Yes | Chain platform: `eth`, `bsc`, `solana`, `base` |\r
| interval | string | Yes | Kline interval (see Interval Reference below) |\r
| limit | number | No | Number of candles to return (has higher priority than `from`) |\r
| from | number | No | Start timestamp in milliseconds |\r
| to | number | No | End timestamp in milliseconds |\r
| pm | string | No | Kline type: `p` for price, `m` for market cap (default: `p`) |\r
\r
**Interval Reference**:\r
\r
| Interval | Description |\r
|----------|-------------|\r
| 1s | 1 second |\r
| 1min | 1 minute |\r
| 3min | 3 minutes |\r
| 5min | 5 minutes |\r
| 15min | 15 minutes |\r
| 30min | 30 minutes |\r
| 1h | 1 hour |\r
| 2h | 2 hours |\r
| 4h | 4 hours |\r
| 6h | 6 hours |\r
| 8h | 8 hours |\r
| 12h | 12 hours |\r
| 1d | 1 day |\r
| 3d | 3 days |\r
| 1w | 1 week |\r
| 1m | 1 month |\r
\r
**Platform Mapping**:\r
\r
| Chain | platform value |\r
|-------|---------------|\r
| Ethereum | eth |\r
| BSC | bsc |\r
| Solana | solana |\r
| Base | base |\r
\r
**Request Headers**:\r
```\r
Accept-Encoding: identity\r
```\r
\r
**Example Request**:\r
```bash\r
curl --location 'https://dquery.sintral.io/u-kline/v1/k-line/candles?address=0x55d398326f99059ff775485246999027b3197955&interval=1min&limit=500&platform=bsc&to=1772126280000' \\r
--header 'Accept-Encoding: identity'\r
```\r
\r
**Response Example**:\r
```json\r
{\r
    "data": [\r
        [0.10779318, 0.10779318, 0.10778039, 0.10778039, 2554.06, 1772125800000, 3],\r
        [0.10778039, 0.10781213, 0.10770104, 0.10770104, 2994.53, 1772125920000, 3],\r
        [0.10770104, 0.10770104, 0.10769200, 0.10769200, 2825.65, 1772126040000, 3],\r
        [0.10769200, 0.10777858, 0.10766827, 0.10777858, 2457.99, 1772126160000, 3],\r
        [0.10777858, 0.10778521, 0.10764351, 0.10764351, 3106.87, 1772126280000, 4]\r
    ],\r
    "status": {\r
        "timestamp": "2026-02-28T05:52:25.717Z",\r
        "error_code": "0",\r
        "error_message": "SUCCESS",\r
        "elapsed": "0",\r
        "credit_count": 0\r
    }\r
}\r
```\r
\r
**Response Fields**:\r
\r
Each candle is an array with 7 elements in order:\r
\r
| Index | Field | Type | Description |\r
|-------|-------|------|-------------|\r
| 0 | open | number | Open price |\r
| 1 | high | number | High price |\r
| 2 | low | number | Low price |\r
| 3 | close | number | Close price |\r
| 4 | volume | number | Trading volume |\r
| 5 | timestamp | number | Candle timestamp (ms) |\r
| 6 | count | number | Transaction count |\r
\r
---\r
\r
## Notes\r
\r
1. Icon URL requires full domain prefix: `https://bin.bnbstatic.com` + icon path\r
2. All numeric fields are string format, convert when using\r
3. Dynamic data updates in real-time, suitable for market display\r
4. K-Line API uses `platform` (eth/bsc/solana/base) instead of `chainId`, and `limit` takes priority over `from` when both are provided\r
5. K-Line response is a 2D array (not JSON objects) — parse by index: [open, high, low, close, volume, timestamp, count]\r

安全使用建议

This skill appears coherent and low-risk: it only documents public Binance web3 API calls and requires no credentials or installation. Before installing, consider that (1) it will make network requests to web3.binance.com when invoked (verify you are comfortable with that external data flow), (2) the skill's source and homepage are missing—if provenance matters to you, prefer skills with a verifiable publisher or official documentation link, and (3) public APIs can have rate limits and occasional data inaccuracies, so do not treat results as authoritative for high-value decisions.

功能分析

Type: OpenClaw Skill Name: binance-query-token Version: 1.0.0 The skill bundle provides instructions for an AI agent to query cryptocurrency token metadata, market data, and candlestick charts using public Binance APIs and a K-line data provider (sintral.io). The code and instructions are well-documented, align strictly with the stated purpose of token research, and contain no evidence of data exfiltration, malicious execution, or prompt injection attacks.

能力评估

✓ Purpose & Capability

Name/description describe token search, metadata, market and K-Line data and the SKILL.md exclusively documents Binance web3 public APIs that provide exactly those capabilities. There are no unrelated credentials, binaries, or config paths requested.

✓ Instruction Scope

Runtime instructions are limited to constructing GET requests against documented web3.binance.com endpoints (examples use curl). The instructions do not tell the agent to read local files, access unrelated environment variables, or transmit data to unexpected endpoints.

✓ Install Mechanism

This is an instruction-only skill with no install spec and no code files, so nothing is written to disk or installed at runtime.

✓ Credentials

The skill declares no required environment variables, credentials, or config paths. That aligns with its use of public, unauthenticated GET endpoints.

✓ Persistence & Privilege

always is false and the skill does not request persistent or elevated privileges. Autonomous invocation is allowed by default but is not combined with any broad credential access or unusual capabilities.

版本历史

v1.0.0

Version 1.0.0 – Initial Release - Skill enables querying token info by keyword, contract address, or chain. - Provides token search, metadata (name, symbol, links, creator info), real-time market data (price, volume, liquidity, holders), and K-Line candlestick charts. - Supports BSC, Base, and Solana chains. - Designed for token discovery, project research, market analysis, and charting.

元数据

Slug binance-query-token

版本 1.0.0

许可证 —

累计安装 2

当前安装数 2

历史版本数 1

常见问题

Binance Query Token 是什么？

Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 340 次。

如何安装 Binance Query Token？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install binance-query-token」即可一键安装，无需额外配置。

Binance Query Token 是免费的吗？

是的，Binance Query Token 完全免费（开源免费），可自由下载、安装和使用。

Binance Query Token 支持哪些平台？

Binance Query Token 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Binance Query Token？

由 viktor-huang（@viktor-huang）开发并维护，当前版本 v1.0.0。

Binance Query Token