mcpField
Q
query-token-info

query-token-info

github.com/binanceOther1.1k8.9k installsUpdated 2d ago
Repository

About query-token-info

A CLI-backed skill for querying token search results, metadata, live market metrics, and candlestick data across Ethereum, BSC, Base, and Solana. It suits agents that need read-only token research through four focused commands.

Key features

  1. 01Search tokens by name, symbol, or address
  2. 02Retrieve metadata and creator details
  3. 03Read live price, volume, holders, and liquidity
  4. 04Fetch OHLCV candlestick series

Use cases

  1. 01Find a token across supported chains
  2. 02Review a token's metadata and social links
  3. 03Check current market metrics
  4. 04Retrieve candles for technical analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/binance/binance-skills-hub --skill query-token-info

After installing, type/query-token-infoin Claude Code to confirm it loaded.

Bundled filesreferences/cli.mdscripts/cli.mjs

Details

From the project README

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 intentCommand
Search a token by keyword, symbol, or contract addresssearch
Get static metadata (name, symbol, logo, social links, creator)meta
Get real-time market data (price, volume, holders, liquidity)dynamic
Get candlestick chart / OHLCV datakline

Supported Chains

ChainchainId
Ethereum1
BSC56
Base8453
SolanaCT_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

CommandPurposeRequired argsExample
searchSearch tokens by keywordkeyword (optional: chainIds, orderBy)node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"1,56,8453,CT_501"}'
metaStatic token metadatachainId, contractAddressnode <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}'
dynamicReal-time market datachainId, contractAddressnode <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}'
klineCandlestick datachainId, 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.

Comments

Markdown supported