query-token-info - SKILL.md Agent Skill

name: query-token-info description: | Per-token details for a specific token identified by keyword, symbol, or contract address: (1) search — find tokens by keyword/symbol/contract; (2) meta — static info: name, symbol, logo, social links, creator, official website; (3) dynamic — real-time market data: price, 24h change, volume, holder count, liquidity; (4) kline — OHLCV candlestick data for technical analysis. Use for: "price of $X", "search for token Y", "kline chart for $Z", "who created $W", "social links for $V", "holder count of $U", "candlestick data", "find the contract address of ". metadata: author: binance-web3-team version: "2.0"

Query Token Info Skill

Overview

Four read-only token endpoints fronted by one CLI. The agent picks a subcommand and passes a JSON blob; with this skill user can:

Search Tokens: Find tokens by name, symbol, or contract address across chains. Token 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.

When to Use This Skill

User intent	Command
Search a token by keyword, symbol, or contract address	`search`
Get static metadata (name, symbol, logo, social links, creator)	`meta`
Get real-time market data (price, volume, holders, liquidity)	`dynamic`
Get candlestick chart / OHLCV data	`kline`

Supported Chains

Chain	`chainId`
Ethereum	`1`
BSC	`56`
Base	`8453`
Solana	`CT_501`

All four commands (search, meta, dynamic, kline) use the same chainId values.

How to Call APIs

node <skill-dir>/scripts/cli.mjs <command> '<json_params>'

Example:

node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'

Commands

Command	Purpose	Required args	Example
`search`	Search tokens by keyword	`keyword` (optional: `chainIds`, `orderBy`)	`node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"1,56,8453,CT_501"}'`
`meta`	Static token metadata	`chainId`, `contractAddress`	`node <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}'`
`dynamic`	Real-time market data	`chainId`, `contractAddress`	`node <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}'`
`kline`	Candlestick data	`chainId`, `contractAddress`, `interval` (optional: `limit`, `from`, `to`, `pm`)	`node <skill-dir>/scripts/cli.mjs kline '{"chainId":"56","contractAddress":"0x...","interval":"1min","limit":500}'`

Rules

Icon URL: icon fields are relative paths. Prepend https://bin.bnbstatic.com for a usable URL.
Numbers as strings: All numeric market fields (price, volume24h, marketCap, etc.) are returned as strings. Convert before arithmetic.
Kline is a 2D array, not JSON objects. Each candle: [open, high, low, close, volume, timestamp_ms, count].
Kline time window: limit takes priority over from when both are provided. Use to with limit to fetch the N most recent candles ending at to. pm selects price (p, default) or market-cap (m) series.
Intervals supported by kline: 1s, 1min, 3min, 5min, 15min, 30min, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1m.

Full CLI Reference

See references/cli.md for per-subcommand invocations, parameter tables, return-field tables, and real response samples.