Description

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

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

Usage Guidance

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.

Capability Analysis

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.

Capability Assessment

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

Version History

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.

Metadata

Slug binance-query-token

Version 1.0.0

License —

All-time Installs 2

Active Installs 2

Total Versions 1

Frequently Asked Questions

What is 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,... It is an AI Agent Skill for Claude Code / OpenClaw, with 340 downloads so far.

How do I install Binance Query Token?

Run "/install binance-query-token" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Binance Query Token free?

Yes, Binance Query Token is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Binance Query Token support?

Binance Query Token is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Binance Query Token?

It is built and maintained by viktor-huang (@viktor-huang); the current version is v1.0.0.

More Skills

Binance Query Token