.agents/skills/query-token-info/references/cli.md
Complete reference for every command in scripts/cli.mjs.
Invocation pattern: node <skill-dir>/scripts/cli.mjs <command> '<json_params>'
Exit codes: 0 success · 1 usage/upstream error · 3 network failure
search — Search tokens by keywordnode <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'
| Param | Type | Required | Description |
|---|---|---|---|
keyword | string | yes | Name / symbol / contract address |
chainIds | string | no | Comma-separated chainIds (e.g. "56", "1,56,8453,CT_501"); default: all |
orderBy | string | no | Sort key, e.g. volume24h |
.data[])| Field | Type | Description |
|---|---|---|
chainId | string | Chain identifier (e.g. "56" = BSC) |
contractAddress | string | Token contract address |
tokenId | string | Binance-internal token ID (stable across address changes) |
name, symbol | string | Token display names |
icon | string | Logo path — prefix with https://bin.bnbstatic.com |
price, percentChange24h | string | Latest USD price and 24h change (%) |
volume24h, marketCap, liquidity | string | All USD; string-encoded decimals |
tagsInfo | object | Risk / recognition tags, categorized (e.g. "Sensitive Events": [...], "Community Recognition Level": [...]) |
meta — Static token metadatanode <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}'
| Param | Type | Required | Description |
|---|---|---|---|
chainId | string | yes | Chain identifier |
contractAddress | string | yes | Token contract address (case-insensitive) |
.data)| Field | Type | Description |
|---|---|---|
tokenId | string | Binance-internal stable ID |
name, symbol, decimals | — | Display name, ticker, precision |
chainName, chainIconUrl | string | Chain display info |
links | array of {label, link} | Website / whitepaper / social links |
aiNarrativeFlag | number | 1 = AI has narrative summary available |
nativeAddressFlag | boolean | true = native chain coin (not an ERC-20) |
links[] entries are {label, link} — labels include "website", "whitepaper", social platforms.
dynamic — Real-time market datanode <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}'
| Param | Type | Required | Description |
|---|---|---|---|
chainId | string | yes | Chain identifier |
contractAddress | string | yes | Token contract address |
.data)Price + volume/buy/sell breakdowns across multiple windows (5m, 1h, 4h, 24h), separated by on-chain vs Binance-routed:
| Field pattern | Meaning |
|---|---|
price, nativeTokenPrice | Current USD price and chain-native price |
volume{5m,1h,4h,24h} | Total trading volume in window (USD) |
volume{window}{Buy,Sell} | Direction breakdown |
volume{window}Binance | Binance-routed subset |
volume{window}Net{Buy,Binance} | Net flow = Buy − Sell |
holders | Holder count (if available) |
liquidity | Current liquidity in USD |
kline — Candlestick OHLCVnode <skill-dir>/scripts/cli.mjs kline '{"chainId":"56","contractAddress":"0x...","interval":"1h","limit":24}'
| Param | Type | Required | Description |
|---|---|---|---|
chainId | string | yes | Chain identifier — 1 (Ethereum) / 56 (BSC) / 8453 (Base) / CT_501 (Solana) |
contractAddress | string | yes | Token contract address |
interval | string | yes | Candle size: 1s / 1min / 3min / 5min / 15min / 30min / 1h / 2h / 4h / 6h / 8h / 12h / 1d / 3d / 1w / 1m |
limit | number | no | Optional. Max 500 per request. Has higher priority than from when both provided. |
from | number | no | Optional. Start timestamp in milliseconds. |
to | number | no | Optional. End timestamp in milliseconds. |
pm | string | no | Optional. Price mode — p (price, default) or m (marketcap). |
.data[])Each row is a 2D array (7 numbers):
| Index | Field |
|---|---|
[0] | open price (USD) |
[1] | high price |
[2] | low price |
[3] | close price |
[4] | volume |
[5] | timestamp (ms since epoch, start of candle) |
[6] | trade count |
Envelope is { data, status: {error_code, error_message} } — no code field (unlike other commands).
Exit codes: 0 ok · 1 upstream/usage (stderr: reason; stdout: body with business code) · 3 network.
Business code: 000000 ok · 100004 rate-limited · 100002 bad param · 000400 token not found / unsupported chain.