1---
2name: query-token-info
3description: |
4  Per-token details for a specific token identified by keyword, symbol, or contract address:
5  (1) search — find tokens by keyword/symbol/contract;
6  (2) meta — static info: name, symbol, logo, social links, creator, official website;
7  (3) dynamic — real-time market data: price, 24h change, volume, holder count, liquidity;
8  (4) kline — OHLCV candlestick data for technical analysis.
9  Use for: "price of $X", "search for token Y", "kline chart for $Z", "who created $W",
10  "social links for $V", "holder count of $U", "candlestick data", "find the contract address of <token>".
11metadata:
12  author: binance-web3-team
13  version: "2.0"
14---
15 
16# Query Token Info Skill
17 
18## Overview
19 
20Four read-only token endpoints fronted by one CLI. The agent picks a subcommand and passes
21a JSON blob; with this skill user can:
22 
23Search Tokens: Find tokens by name, symbol, or contract address across chains.
24Token Research: Get token metadata, social links, and creator info.
25Market Analysis: Real-time price, volume, holder distribution, and liquidity data.
26Chart Analysis: K-Line candlestick data for technical analysis.
27 
28## When to Use This Skill
29 
30| User intent | Command |
31|-------------|---------|
32| Search a token by keyword, symbol, or contract address | `search` |
33| Get static metadata (name, symbol, logo, social links, creator) | `meta` |
34| Get real-time market data (price, volume, holders, liquidity) | `dynamic` |
35| Get candlestick chart / OHLCV data | `kline` |
36 
37## Supported Chains
38 
39| Chain | `chainId` |
40|-------|-----------|
41| Ethereum | `1` |
42| BSC | `56` |
43| Base | `8453` |
44| Solana | `CT_501` |
45 
46All four commands (`search`, `meta`, `dynamic`, `kline`) use the same `chainId` values.
47 
48## How to Call APIs
49 
50```bash
51node <skill-dir>/scripts/cli.mjs <command> '<json_params>'
52```
53 
54Example:
55 
56```bash
57node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'
58```
59 
60## Commands
61 
62| Command | Purpose | Required args | Example |
63|---------|---------|---------------|---------|
64| `search` | Search tokens by keyword | `keyword` (optional: `chainIds`, `orderBy`) | `node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"1,56,8453,CT_501"}'` |
65| `meta` | Static token metadata | `chainId`, `contractAddress` | `node <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}'` |
66| `dynamic` | Real-time market data | `chainId`, `contractAddress` | `node <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}'` |
67| `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}'` |
68 
69## Rules
70 
71- **Icon URL**: `icon` fields are relative paths. Prepend `https://bin.bnbstatic.com` for a usable URL.
72- **Numbers as strings**: All numeric market fields (`price`, `volume24h`, `marketCap`, etc.) are
73  returned as strings. Convert before arithmetic.
74- **Kline is a 2D array**, not JSON objects. Each candle: `[open, high, low, close, volume, timestamp_ms, count]`.
75- **Kline time window**: `limit` takes priority over `from` when both are provided. Use `to`
76  with `limit` to fetch the N most recent candles ending at `to`. `pm` selects price (`p`,
77  default) or market-cap (`m`) series.
78- **Intervals** supported by `kline`: `1s`, `1min`, `3min`, `5min`, `15min`, `30min`, `1h`, `2h`,
79  `4h`, `6h`, `8h`, `12h`, `1d`, `3d`, `1w`, `1m`.
80 
81## Full CLI Reference
82 
83See [`references/cli.md`](references/cli.md) for per-subcommand invocations, parameter tables, return-field tables, and real response samples.
84