skilld
All skills
binance avatar

/query-token-info

@13ac2f7
by binancebinance/binance-skills-hub1k stars
232

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>".

Ask your Agent

Use this Skill: https://skilld.dev/gh/binance/binance-skills-hub/query-token-info

This session only. Nothing lands on disk.

referencescli.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

query-token-info — CLI Reference

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 keyword

node <skill-dir>/scripts/cli.mjs search '{"keyword":"<keyword>","chainIds":"56"}'

Parameters

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

Return fields (under .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 metadata

node <skill-dir>/scripts/cli.mjs meta '{"chainId":"56","contractAddress":"0x..."}'

Parameters

Param Type Required Description
chainId string yes Chain identifier
contractAddress string yes Token contract address (case-insensitive)

Return fields (under .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 data

node <skill-dir>/scripts/cli.mjs dynamic '{"chainId":"56","contractAddress":"0x..."}'

Parameters

Param Type Required Description
chainId string yes Chain identifier
contractAddress string yes Token contract address

Return fields (under .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 OHLCV

node <skill-dir>/scripts/cli.mjs kline '{"chainId":"56","contractAddress":"0x...","interval":"1h","limit":24}'

Parameters

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).

Return shape (under .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).

Errors

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.

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides utility for querying token information, market data, and technical charts via Binance and Sintral data services. It uses a self-contained Node.js script to perform read-only API calls. No security issues or malicious patterns were identified.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 2 issues

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 13ac2f7. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 4 months ago

Capability

metadata
{
  "author": "binance-web3-team",
  "version": "2.0"
}

Topics

  • binance
  • token
  • search
  • metadata
  • market-data
  • price
  • kline
  • blockchain
  • ethereum
  • solana

README badge

README badge for binance/binance-skills-hub/query-token-info

What it does

Retrieves token metadata, real-time market data, and candlestick charts across Ethereum, BSC, Base, and Solana via four CLI commands: search tokens by keyword or address, fetch static info like name and social links, pull live price and volume data, and query OHLCV candlestick data for technical analysis.

Generated from the current SKILL.md.

Frequently asked

What chains does this skill support?
Ethereum, BSC, Base, and Solana. Each chain has a chainId value (1, 56, 8453, CT_501 respectively) that you pass to the commands.
Can I search tokens across multiple chains at once?
Yes. The `search` command accepts a comma-separated list of chainIds, e.g. `chainIds: "1,56,8453,CT_501"` to search all supported chains in one call.
What time intervals does the kline command support?
1s, 1min, 3min, 5min, 15min, 30min, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, and 1m.
Are numeric values like price and volume returned as numbers or strings?
All numeric market fields are returned as strings, so you must convert them before doing arithmetic.
How is icon URL data provided?
Icon fields are relative paths. Prepend `https://bin.bnbstatic.com` to make them usable.

Generated from the current SKILL.md. These answers refresh after source changes.