query-token-info

SKILL.md

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.