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