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