opentrade-token

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenTrade DEX Token Info CLI

OpenTrade DEX Token 信息 CLI

5 commands for token search, metadata, detailed pricing, rankings, and holder distribution.

提供5个命令用于token搜索、元数据查询、详细定价、排名和持仓分布查询。

Pre-flight Checks

前置检查

Every time before running any

opentrade

command, always follow these steps in order. Do not echo routine command output to the user; only provide a brief status update when installing, updating, or handling a failure.

Confirm installed: Run
```
which opentrade
```
. If not found, install it:
bash
```
curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
```
If the install script fails, ask the user to install manually following the instructions at: https://github.com/6551Team/openskills
Check for updates: Read
```
~/.opentrade/last_check
```
and compare it with the current timestamp:
bash
```
cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true)
now=$(date +%s)
```
- If
```
cached_ts
```
  is non-empty and
```
(now - cached_ts) < 43200
```
  (12 hours), skip the update and proceed.
- Otherwise (file missing or older than 12 hours), run the installer to check for updates:
  bash
```
curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
```
  If a newer version is installed, tell the user and suggest updating their opentrade skills from https://github.com/6551Team/openskills to get the latest features.

If any

opentrade

command fails with an unexpected error during this session, try reinstalling before giving up:

bash

curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh

Find or create a .env file in the project root to override the default API credentials, Load it before performing opentrade operations.

bash

OPEN_TOKEN=your_token_here

Get your API token at: https://6551.io/mcp

Security warning: Never commit .env to git (add it to .gitignore) and never expose credentials in logs, screenshots, or chat messages.

每次运行任意

opentrade

命令前，请务必按顺序执行以下步骤。不要向用户回显常规命令的输出，仅在安装、更新或处理故障时提供简要的状态更新。

确认已安装：运行
```
which opentrade
```
，如果未找到则执行安装：
bash
```
curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
```
如果安装脚本运行失败，请告知用户按照https://github.com/6551Team/openskills的说明手动安装。
检查更新：读取
```
~/.opentrade/last_check
```
的内容，与当前时间戳对比：
bash
```
cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true)
now=$(date +%s)
```
- 如果
```
cached_ts
```
  非空且
```
(now - cached_ts) < 43200
```
  （12小时），则跳过更新继续执行。
- 否则（文件不存在或更新时间超过12小时），运行安装脚本检查更新：
  bash
```
curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
```
  如果安装了新版本，告知用户并建议从https://github.com/6551Team/openskills更新opentrade技能以获取最新功能。

如果本次会话中任意

opentrade

命令运行出现意外错误，在放弃前先尝试重新安装：

bash

curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh

在项目根目录找到或创建.env文件覆盖默认API凭证，执行opentrade操作前先加载该文件：

bash

OPEN_TOKEN=your_token_here

你可以在https://6551.io/mcp获取API token。

安全警告：永远不要将.env提交到git（请将它添加到.gitignore中），也永远不要在日志、截图或聊天消息中暴露凭证。

Router Discovery

路由发现

IMPORTANT: If the user has not specified a trading router, you MUST first discover available routers:

bash

opentrade trade routers

Response format:

json

{
  "ok": true,
  "data": [
    {
      "api": "v2",
      "created_at": "2026-03-10 01:15:42",
      "is_active": true,
      "name": "6551dex test",
      "quota_reward": 0,
      "trader": "6551dex",
      "updated_at": "2026-03-10 01:15:42"
    },
    {
      "api": "v1",
      "created_at": "2026-03-03 21:24:34",
      "is_active": true,
      "name": "okx test",
      "quota_reward": 0,
      "trader": "okx",
      "updated_at": "2026-03-03 21:24:34"
    }
  ]
}

Usage:

Extract
```
trader
```
and
```
api
```
from the response
MANDATORY: ALL subsequent
```
opentrade
```
commands in this session MUST include
```
--trader <trader>
```
and
```
--api <api>
```
flags

Example:

opentrade token search USDC --chains ethereum --trader okx --api v1

Default fallback: If the API returns no data or is empty, use
```
--trader okx --api v1
```

重要提示：如果用户未指定交易路由，你必须先发现可用的路由：

bash

opentrade trade routers

响应格式：

json

{
  "ok": true,
  "data": [
    {
      "api": "v2",
      "created_at": "2026-03-10 01:15:42",
      "is_active": true,
      "name": "6551dex test",
      "quota_reward": 0,
      "trader": "6551dex",
      "updated_at": "2026-03-10 01:15:42"
    },
    {
      "api": "v1",
      "created_at": "2026-03-03 21:24:34",
      "is_active": true,
      "name": "okx test",
      "quota_reward": 0,
      "trader": "okx",
      "updated_at": "2026-03-03 21:24:34"
    }
  ]
}

使用方法：

从响应中提取
```
trader
```
和
```
api
```
字段
强制要求：本次会话后续所有
```
opentrade
```
命令必须包含
```
--trader <trader>
```
和
```
--api <api>
```
参数

示例：

opentrade token search USDC --chains ethereum --trader okx --api v1

默认兜底方案：如果API无返回数据或返回为空，请使用
```
--trader okx --api v1
```

Skill Routing

技能路由

For real-time prices / K-lines / trade history → use
```
opentrade-market
```
For swap execution → use
```
opentrade-dex-swap
```
For transaction broadcasting → use
```
opentrade-gateway
```
For wallet balances / portfolio → use
```
opentrade-portfolio
```
For meme token safety (dev reputation, rug pull, bundlers, similar tokens by same dev) → use
```
opentrade-market
```
For smart money / whale / KOL signals → use
```
opentrade-market
```

实时价格/K线/交易历史 → 使用
```
opentrade-market
```
兑换执行 → 使用
```
opentrade-dex-swap
```
交易广播 → 使用
```
opentrade-gateway
```
钱包余额/投资组合 → 使用
```
opentrade-portfolio
```
Meme币安全（开发者信誉、rug pull、批量交易、同开发者相似token） → 使用
```
opentrade-market
```
聪明钱/巨鲸/KOL信号 → 使用
```
opentrade-market
```

Quickstart

快速开始

bash

undefined

bash

undefined

Search token

搜索token

opentrade token search xETH --chains "ethereum,solana"

Get detailed price info

获取详细价格信息

opentrade token price-info 0xe7b000003a45145decf8a28fc755ad5ec5ea025a --chain xlayer

What's trending on Solana by volume?

Solana上按交易量排名的热门token有哪些？

opentrade token toplist --chains solana --sort-by 5 --time-frame 4

Check holder distribution

查询持仓分布

opentrade token holders 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer

undefined

opentrade token holders 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer

undefined

Chain Name Support

支持的链名称

The CLI accepts human-readable chain names (e.g.,

ethereum

solana

xlayer

) and resolves them automatically.

Chain	Name	chainIndex
XLayer	`xlayer`	`196`
Solana	`solana`	`501`
Ethereum	`ethereum`	`1`
Base	`base`	`8453`
BSC	`bsc`	`56`
Arbitrum	`arbitrum`	`42161`
Polygon	`polygon`	`137`
Optimism	`optimism`	`10`
Avalanche	`avalanche`	`43114`
Fantom	`fantom`	`250`
Cronos	`cronos`	`25`
Gnosis	`gnosis`	`100`
Klaytn	`klaytn`	`8217`
Aurora	`aurora`	`1313161554`
Harmony	`harmony`	`1666600000`
Moonbeam	`moonbeam`	`1284`
Moonriver	`moonriver`	`1285`
Celo	`celo`	`42220`
Fuse	`fuse`	`122`
OKC	`okc`	`66`
Heco	`heco`	`128`
Metis	`metis`	`1088`
Boba	`boba`	`288`
zkSync Era	`zksync`	`324`
Polygon zkEVM	`polygon-zkevm`	`1101`
Linea	`linea`	`59144`
Mantle	`mantle`	`5000`
Scroll	`scroll`	`534352`
Blast	`blast`	`81457`

CLI支持人类可读的链名称（例如

ethereum

、

solana

、

xlayer

）并会自动解析。

链	名称	chainIndex
XLayer	`xlayer`	`196`
Solana	`solana`	`501`
Ethereum	`ethereum`	`1`
Base	`base`	`8453`
BSC	`bsc`	`56`
Arbitrum	`arbitrum`	`42161`
Polygon	`polygon`	`137`
Optimism	`optimism`	`10`
Avalanche	`avalanche`	`43114`
Fantom	`fantom`	`250`
Cronos	`cronos`	`25`
Gnosis	`gnosis`	`100`
Klaytn	`klaytn`	`8217`
Aurora	`aurora`	`1313161554`
Harmony	`harmony`	`1666600000`
Moonbeam	`moonbeam`	`1284`
Moonriver	`moonriver`	`1285`
Celo	`celo`	`42220`
Fuse	`fuse`	`122`
OKC	`okc`	`66`
Heco	`heco`	`128`
Metis	`metis`	`1088`
Boba	`boba`	`288`
zkSync Era	`zksync`	`324`
Polygon zkEVM	`polygon-zkevm`	`1101`
Linea	`linea`	`59144`
Mantle	`mantle`	`5000`
Scroll	`scroll`	`534352`
Blast	`blast`	`81457`

Command Index

命令索引


opentrade token search <query>
opentrade token info <address>
opentrade token price-info <address>
opentrade token toplist
opentrade token holders <address>

#	Command	Description
1	`opentrade token search <query>`	Search for tokens by name, symbol, or address
2	`opentrade token info <address>`	Get token basic info (name, symbol, decimals, logo)
3	`opentrade token price-info <address>`	Get detailed price info (price, market cap, liquidity, volume, 24h change)
4	`opentrade token toplist`	Get trending / top tokens
5	`opentrade token holders <address>`	Get token holder distribution (top 20)


opentrade token search <query>
opentrade token info <address>
opentrade token price-info <address>
opentrade token toplist
opentrade token holders <address>

#	命令	描述
1	`opentrade token search <query>`	按名称、符号或地址搜索token
2	`opentrade token info <address>`	获取token基础信息（名称、符号、小数位数、logo）
3	`opentrade token price-info <address>`	获取详细价格信息（价格、市值、流动性、交易量、24小时涨跌幅）
4	`opentrade token toplist`	获取热门/头部token
5	`opentrade token holders <address>`	获取token持仓分布（前20名）

Boundary: token vs market skill

边界：token技能与market技能的区别

Need	Use this skill ( `opentrade-token` )	Use `opentrade-market` instead
Search token by name/symbol	`opentrade token search`	-
Token metadata (decimals, logo)	`opentrade token info`	-
Price + market cap + liquidity + multi-timeframe change	`opentrade token price-info`	-
Token ranking (trending)	`opentrade token toplist`	-
Holder distribution	`opentrade token holders`	-
Raw real-time price (single value)	-	`opentrade market price`
K-line / candlestick chart	-	`opentrade market kline`
Trade history (buy/sell log)	-	`opentrade market trades`
Index price (multi-source aggregate)	-	`opentrade market index`
Meme token dev reputation / rug pull	-	`opentrade market memepump-token-dev-info`
Bundle/sniper detection	-	`opentrade market memepump-token-bundle-info`
Similar tokens by same creator	-	`opentrade market memepump-similar-tokens`

Rule of thumb:

opentrade-token

= token discovery & enriched analytics (search, trending, holders, market cap).

opentrade-market

= raw price feeds, charts, smart money signals & meme pump scanning (including dev reputation, rug pull checks, bundler analysis).

需求	使用本技能（ `opentrade-token` ）	改用 `opentrade-market`
按名称/符号搜索token	`opentrade token search`	-
Token元数据（小数位数、logo）	`opentrade token info`	-
价格+市值+流动性+多时间周期涨跌幅	`opentrade token price-info`	-
Token排名（热门）	`opentrade token toplist`	-
持仓分布	`opentrade token holders`	-
原始实时价格（单值）	-	`opentrade market price`
K线/蜡烛图	-	`opentrade market kline`
交易历史（买卖日志）	-	`opentrade market trades`
指数价格（多源聚合）	-	`opentrade market index`
Meme币开发者信誉/rug pull检测	-	`opentrade market memepump-token-dev-info`
批量/狙杀交易检测	-	`opentrade market memepump-token-bundle-info`
同开发者发行的相似token	-	`opentrade market memepump-similar-tokens`

经验法则：

opentrade-token

= token发现与丰富分析（搜索、热门、持仓、市值）。

opentrade-market

= 原始价格源、图表、聪明钱信号与meme泵扫描（包括开发者信誉、rug pull检测、批量交易分析）。

Cross-Skill Workflows

跨技能工作流

This skill is the typical entry point — users often start by searching/discovering tokens, then proceed to swap.

本技能是典型的入口点——用户通常从搜索/发现token开始，之后进行兑换操作。

Workflow A: Search → Research → Buy

工作流A：搜索 → 调研 → 买入

User: "Find BONK token, analyze it, then buy some"

1. opentrade-token    opentrade token search BONK --chains solana              → get tokenContractAddress, chain, price
       ↓ tokenContractAddress
2. opentrade-token    opentrade token price-info <address> --chain solana      → market cap, liquidity, volume24H, priceChange24H
3. opentrade-token    opentrade token holders <address> --chain solana         → top 20 holders distribution
4. opentrade-market   opentrade market kline <address> --chain solana --bar 1H → hourly price chart
       ↓ user decides to buy
5. opentrade-dex-swap opentrade swap quote --from ... --to <address> --amount ... --chain solana
6. opentrade-dex-swap opentrade swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>

Data handoff:

```
tokenContractAddress
```
from step 1 → reused in all subsequent steps
```
chain
```
from step 1 → reused in all subsequent steps
```
decimal
```
from step 1 or
```
opentrade token info
```
→ needed for minimal unit conversion in swap

用户：「找BONK token，分析一下，然后买一些」

1. opentrade-token    opentrade token search BONK --chains solana              → 获取tokenContractAddress、chain、price
       ↓ tokenContractAddress
2. opentrade-token    opentrade token price-info <address> --chain solana      → 市值、流动性、24小时交易量、24小时价格涨跌幅
3. opentrade-token    opentrade token holders <address> --chain solana         → 前20名持仓分布
4. opentrade-market   opentrade market kline <address> --chain solana --bar 1H → 小时级价格图表
       ↓ 用户决定买入
5. opentrade-dex-swap opentrade swap quote --from ... --to <address> --amount ... --chain solana
6. opentrade-dex-swap opentrade swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>

数据传递：

步骤1获取的
```
tokenContractAddress
```
→ 后续所有步骤复用
步骤1获取的
```
chain
```
→ 后续所有步骤复用
步骤1或
```
opentrade token info
```
获取的
```
decimal
```
→ 兑换时最小单位转换需要用到

Workflow B: Discover Trending → Investigate → Trade

工作流B：发现热门 → 调查 → 交易

User: "What's trending on Solana?"

1. opentrade-token    opentrade token toplist --chains solana --sort-by 5 --time-frame 4  → top tokens by 24h volume
       ↓ user picks a token
2. opentrade-token    opentrade token price-info <address> --chain solana                  → detailed analytics
3. opentrade-token    opentrade token holders <address> --chain solana                     → check if whale-dominated
4. opentrade-market   opentrade market kline <address> --chain solana                      → K-line for visual trend
       ↓ user decides to trade
5. opentrade-dex-swap opentrade swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>

用户：「Solana上什么比较热门？」

1. opentrade-token    opentrade token toplist --chains solana --sort-by 5 --time-frame 4  → 按24小时交易量排名的头部token
       ↓ 用户选择一个token
2. opentrade-token    opentrade token price-info <address> --chain solana                  → 详细分析数据
3. opentrade-token    opentrade token holders <address> --chain solana                     → 检查是否被巨鲸主导
4. opentrade-market   opentrade market kline <address> --chain solana                      → K线查看趋势
       ↓ 用户决定交易
5. opentrade-dex-swap opentrade swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>

Workflow C: Token Verification Before Swap

工作流C：兑换前的token验证

Before swapping an unknown token, always verify:

1. opentrade-token    opentrade token search <name>                            → find token
2. Check communityRecognized:
   - true → proceed with normal caution
   - false → warn user about risk
3. opentrade-token    opentrade token price-info <address> → check liquidity:
   - liquidity < $10K → warn about high slippage risk
   - liquidity < $1K → strongly discourage trade
4. opentrade-dex-swap opentrade swap quote ... → check isHoneyPot and taxRate
5. If all checks pass → proceed to swap

兑换未知token前，务必进行验证：

1. opentrade-token    opentrade token search <name>                            → 找到token
2. 检查communityRecognized字段：
   - true → 保持常规谨慎继续操作
   - false → 警告用户存在风险
3. opentrade-token    opentrade token price-info <address> → 检查流动性：
   - 流动性 < $10K → 警告高滑点风险
   - 流动性 < $1K → 强烈不建议交易
4. opentrade-dex-swap opentrade swap quote ... → 检查isHoneyPot和taxRate字段
5. 所有检查通过 → 继续兑换操作

Operation Flow

操作流程

Step 1: Identify Intent

步骤1：识别意图

Search for a token →
```
opentrade token search
```
Get token metadata →
```
opentrade token info
```
Get price + market cap + liquidity →
```
opentrade token price-info
```
View rankings →
```
opentrade token toplist
```
View holder distribution →
```
opentrade token holders
```

搜索token →
```
opentrade token search
```
获取token元数据 →
```
opentrade token info
```
获取价格+市值+流动性 →
```
opentrade token price-info
```
查看排名 →
```
opentrade token toplist
```
查看持仓分布 →
```
opentrade token holders
```

Step 2: Collect Parameters

步骤2：收集参数

Missing chain → recommend XLayer (
```
--chain xlayer
```
, low gas, fast confirmation) as the default, then ask which chain the user prefers
Only have token name, no address → use
```
opentrade token search
```
first
For search,
```
--chains
```
defaults to
```
"1,501"
```
(Ethereum + Solana)
For toplist,
```
--sort-by
```
defaults to
```
5
```
(volume),
```
--time-frame
```
defaults to
```
4
```
(24h)

缺少链信息 → 默认推荐XLayer（
```
--chain xlayer
```
，低gas、确认快），然后询问用户偏好的链
只有token名称没有地址 → 先使用
```
opentrade token search
```
搜索功能的
```
--chains
```
默认值为
```
"1,501"
```
（Ethereum + Solana）
排名功能的
```
--sort-by
```
默认值为
```
5
```
（交易量），
```
--time-frame
```
默认值为
```
4
```
（24小时）

Step 3: Call and Display

步骤3：调用并展示

Search results: show name, symbol, chain, price, 24h change
Indicate
```
communityRecognized
```
status for trust signaling
Price info: show market cap, liquidity, and volume together

搜索结果：展示名称、符号、链、价格、24小时涨跌幅
标注
```
communityRecognized
```
状态作为信任参考
价格信息：同时展示市值、流动性和交易量

Step 4: Suggest Next Steps

步骤4：建议后续操作

After displaying results, suggest 2-3 relevant follow-up actions based on the command just executed:

Just called	Suggest
`token search`	1. View detailed analytics (market cap, liquidity) → `opentrade token price-info` (this skill) 2. View price chart → `opentrade-market` 3. Buy/swap this token → `opentrade-dex-swap`
`token info`	1. View price and market data → `opentrade token price-info` (this skill) 2. Check holder distribution → `opentrade token holders` (this skill)
`token price-info`	1. View K-line chart → `opentrade-market` 2. Check holder distribution → `opentrade token holders` (this skill) 3. Buy/swap this token → `opentrade-dex-swap`
`token toplist`	1. View details for a specific token → `opentrade token price-info` (this skill) 2. View price chart → `opentrade-market` 3. Buy a trending token → `opentrade-dex-swap`
`token holders`	1. View price trend → `opentrade-market` 2. Buy/swap this token → `opentrade-dex-swap`

Present conversationally, e.g.: "Would you like to see the price chart or check the holder distribution?" — never expose skill names or endpoint paths to the user.

展示结果后，根据刚刚执行的命令建议2-3个相关的后续操作：

刚刚执行的命令	建议操作
`token search`	1. 查看详细分析（市值、流动性）→ `opentrade token price-info` （本技能） 2. 查看价格图表 → `opentrade-market` 3. 买入/兑换这个token → `opentrade-dex-swap`
`token info`	1. 查看价格和市场数据 → `opentrade token price-info` （本技能） 2. 检查持仓分布 → `opentrade token holders` （本技能）
`token price-info`	1. 查看K线图表 → `opentrade-market` 2. 检查持仓分布 → `opentrade token holders` （本技能） 3. 买入/兑换这个token → `opentrade-dex-swap`
`token toplist`	1. 查看特定token的详情 → `opentrade token price-info` （本技能） 2. 查看价格图表 → `opentrade-market` 3. 买入热门token → `opentrade-dex-swap`
`token holders`	1. 查看价格趋势 → `opentrade-market` 2. 买入/兑换这个token → `opentrade-dex-swap`

请以对话形式呈现，例如：「你想查看价格图表还是检查持仓分布？」——永远不要向用户暴露技能名称或接口路径。

CLI Command Reference

CLI命令参考

1. opentrade token search

Search for tokens by name, symbol, or contract address.

bash

opentrade token search <query> [--chains <chains>]

Param	Required	Default	Description
`<query>`	Yes	-	Keyword: token name, symbol, or contract address (positional)
`--chains`	No	`"1,501"`	Chain names or IDs, comma-separated (e.g., `"ethereum,solana"` or `"196,501"` )

Return fields:

Field	Type	Description
`tokenContractAddress`	String	Token contract address
`tokenSymbol`	String	Token symbol (e.g., `"ETH"` )
`tokenName`	String	Token full name
`tokenLogoUrl`	String	Token logo image URL
`chainIndex`	String	Chain identifier
`decimal`	String	Token decimals (e.g., `"18"` )
`price`	String	Current price in USD
`change`	String	24-hour price change percentage
`marketCap`	String	Market capitalization in USD
`liquidity`	String	Liquidity in USD
`holders`	String	Number of token holders
`explorerUrl`	String	Block explorer URL for the token
`tagList.communityRecognized`	Boolean	`true` = listed on Top 10 CEX or community verified

按名称、符号或合约地址搜索token。

bash

opentrade token search <query> [--chains <chains>]

参数	必填	默认值	描述
`<query>`	是	-	关键词：token名称、符号或合约地址（位置参数）
`--chains`	否	`"1,501"`	链名称或ID，逗号分隔（例如 `"ethereum,solana"` 或 `"196,501"` ）

返回字段：

字段	类型	描述
`tokenContractAddress`	字符串	Token合约地址
`tokenSymbol`	字符串	Token符号（例如 `"ETH"` ）
`tokenName`	字符串	Token全称
`tokenLogoUrl`	字符串	Token logo图片URL
`chainIndex`	字符串	链标识符
`decimal`	字符串	Token小数位数（例如 `"18"` ）
`price`	字符串	当前美元价格
`change`	字符串	24小时价格涨跌幅百分比
`marketCap`	字符串	美元市值
`liquidity`	字符串	美元流动性
`holders`	字符串	Token持仓人数
`explorerUrl`	字符串	该token的区块浏览器URL
`tagList.communityRecognized`	布尔值	`true` = 已上线头部10家CEX或通过社区验证

2. opentrade token info

Get token basic info (name, symbol, decimals, logo).

bash

opentrade token info <address> [--chain <chain>]

Param	Required	Default	Description
`<address>`	Yes	-	Token contract address (positional)
`--chain`	No	`ethereum`	Chain name

Return fields:

Field	Type	Description
`tokenContractAddress`	String	Contract address
`tokenSymbol`	String	Token symbol
`tokenName`	String	Full name
`chainIndex`	String	Chain identifier
`decimal`	String	Token decimals
`totalSupply`	String	Total supply
`logoUrl`	String	Token logo URL
`websiteUrl`	String	Official website
`twitterUrl`	String	Twitter/X profile
`telegramUrl`	String	Telegram group
`discordUrl`	String	Discord server
`communityRecognized`	Boolean	Verification status

获取token基础信息（名称、符号、小数位数、logo）。

bash

opentrade token info <address> [--chain <chain>]

参数	必填	默认值	描述
`<address>`	是	-	Token合约地址（位置参数）
`--chain`	否	`ethereum`	链名称

返回字段：

字段	类型	描述
`tokenContractAddress`	字符串	合约地址
`tokenSymbol`	字符串	Token符号
`tokenName`	字符串	全称
`chainIndex`	字符串	链标识符
`decimal`	字符串	Token小数位数
`totalSupply`	字符串	总发行量
`logoUrl`	字符串	Token logo URL
`websiteUrl`	字符串	官方网站
`twitterUrl`	字符串	Twitter/X主页
`telegramUrl`	字符串	Telegram群组
`discordUrl`	字符串	Discord服务器
`communityRecognized`	布尔值	验证状态

3. opentrade token price-info

Get detailed price, market cap, liquidity, volume, and multi-timeframe changes.

bash

opentrade token price-info <address> [--chain <chain>]

Param	Required	Default	Description
`<address>`	Yes	-	Token contract address (positional)
`--chain`	No	`ethereum`	Chain name

Return fields:

Field	Type	Description
`price`	String	Current price in USD
`priceChange1h`	String	1h price change %
`priceChange4h`	String	4h price change %
`priceChange12h`	String	12h price change %
`priceChange24h`	String	24h price change %
`volume24h`	String	24h trading volume
`liquidity`	String	Total liquidity in USD
`liquidityChange24h`	String	24h liquidity change %
`marketCap`	String	Market capitalization
`fullyDilutedValuation`	String	FDV
`holders`	String	Number of token holders
`transactions24h`	String	24h transaction count
`buys24h`	String	24h buy count
`sells24h`	String	24h sell count

获取详细价格、市值、流动性、交易量和多时间周期涨跌幅。

bash

opentrade token price-info <address> [--chain <chain>]

参数	必填	默认值	描述
`<address>`	是	-	Token合约地址（位置参数）
`--chain`	否	`ethereum`	链名称

返回字段：

字段	类型	描述
`price`	字符串	当前美元价格
`priceChange1h`	字符串	1小时价格涨跌幅%
`priceChange4h`	字符串	4小时价格涨跌幅%
`priceChange12h`	字符串	12小时价格涨跌幅%
`priceChange24h`	字符串	24小时价格涨跌幅%
`volume24h`	字符串	24小时交易量
`liquidity`	字符串	总美元流动性
`liquidityChange24h`	字符串	24小时流动性涨跌幅%
`marketCap`	字符串	市值
`fullyDilutedValuation`	字符串	完全稀释估值（FDV）
`holders`	字符串	Token持仓人数
`transactions24h`	字符串	24小时交易次数
`buys24h`	字符串	24小时买入次数
`sells24h`	字符串	24小时卖出次数

4. opentrade token toplist

Get trending / top tokens by various metrics.

bash

opentrade token toplist [--chains <chains>] [--sort-by <n>] [--time-frame <n>]

Param	Required	Default	Description
`--chains`	No	`"1,501"`	Chain names or IDs, comma-separated
`--sort-by`	No	`5`	Sort metric: `2` = price change, `5` = volume, `6` = market cap
`--time-frame`	No	`4`	Time window: `1` = 5min, `2` = 1h, `3` = 4h, `4` = 24h

Return fields (array of tokens):

Field	Type	Description
`tokenContractAddress`	String	Token contract address
`tokenSymbol`	String	Token symbol
`chainIndex`	String	Chain identifier
`price`	String	Current price
`change`	String	Price change % for selected time frame
`volume`	String	Volume for selected time frame
`marketCap`	String	Market capitalization
`liquidity`	String	Liquidity in USD

按不同指标获取热门/头部token。

bash

opentrade token toplist [--chains <chains>] [--sort-by <n>] [--time-frame <n>]

参数	必填	默认值	描述
`--chains`	否	`"1,501"`	链名称或ID，逗号分隔
`--sort-by`	否	`5`	排序指标： `2` = 价格涨跌幅， `5` = 交易量， `6` = 市值
`--time-frame`	否	`4`	时间窗口： `1` = 5分钟， `2` = 1小时， `3` = 4小时， `4` = 24小时

返回字段（token数组）：

字段	类型	描述
`tokenContractAddress`	字符串	Token合约地址
`tokenSymbol`	字符串	Token符号
`chainIndex`	字符串	链标识符
`price`	字符串	当前价格
`change`	字符串	所选时间周期的价格涨跌幅%
`volume`	字符串	所选时间周期的交易量
`marketCap`	字符串	市值
`liquidity`	字符串	美元流动性

5. opentrade token holders

Get token holder distribution (top 20).

bash

opentrade token holders <address> [--chain <chain>]

Param	Required	Default	Description
`<address>`	Yes	-	Token contract address (positional)
`--chain`	No	`ethereum`	Chain name

Return fields (top 20 holders):

Field	Type	Description
`data[].holdAmount`	String	Token amount held
`data[].holderWalletAddress`	String	Holder wallet address

获取token持仓分布（前20名）。

bash

opentrade token holders <address> [--chain <chain>]

参数	必填	默认值	描述
`<address>`	是	-	Token合约地址（位置参数）
`--chain`	否	`ethereum`	链名称

返回字段（前20名持仓者）：

字段	类型	描述
`data[].holdAmount`	字符串	持仓token数量
`data[].holderWalletAddress`	字符串	持仓者钱包地址

Input / Output Examples

输入/输出示例

User says: "Search for xETH token on XLayer"

bash

opentrade token search xETH --chains xlayer

用户说：「在XLayer上搜索xETH token」

bash

opentrade token search xETH --chains xlayer

→ Display:

→ 展示：

xETH (0xe7b0...) - XLayer

Price: $X,XXX.XX | 24h: +X% | Market Cap: $XXM | Liquidity: $XXM

价格: $X,XXX.XX | 24小时涨跌幅: +X% | 市值: $XXM | 流动性: $XXM

Community Recognized: Yes

社区认证: 是


**User says:** "What's trending on Solana by volume?"

```bash
opentrade token toplist --chains solana --sort-by 5 --time-frame 4


**用户说：**「Solana上按交易量排名的热门token有哪些？」

```bash
opentrade token toplist --chains solana --sort-by 5 --time-frame 4

→ Display top tokens sorted by 24h volume:

→ 展示按24小时交易量排序的头部token：

#1 SOL - Vol: $1.2B | Change: +3.5% | MC: $80B

#1 SOL - 交易量: $1.2B | 涨跌幅: +3.5% | 市值: $80B

#2 BONK - Vol: $450M | Change: +12.8% | MC: $1.5B

#2 BONK - 交易量: $450M | 涨跌幅: +12.8% | 市值: $1.5B

...


**User says:** "Who are the top holders of this token?"

```bash
opentrade token holders 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer


**用户说：**「这个token的 top 持仓者有哪些？」

```bash
opentrade token holders 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer

→ Display top 20 holders with amounts and addresses

→ 展示前20名持仓者的持仓数量和地址

undefined

undefined

Edge Cases

边界情况

Token not found: suggest verifying the contract address (symbols can collide)
Same symbol on multiple chains: show all matches with chain names
Unverified token:
```
communityRecognized = false
```
— warn user about risk
Too many results: name/symbol search caps at 100 — suggest using exact contract address
Network error: retry once
Region restriction (error code 50125 or 80001): do NOT show the raw error code to the user. Instead, display a friendly message:
```
⚠️ Service is not available in your region. Please switch to a supported region and try again.
```

未找到token：建议验证合约地址（符号可能重复）
多条链存在相同符号的token：展示所有匹配结果并标注链名称
未认证的token：
```
communityRecognized = false
```
— 警告用户存在风险
结果过多：名称/符号搜索最多返回100条结果 — 建议使用精确的合约地址搜索
网络错误：重试一次
区域限制（错误码50125或80001）：不要向用户展示原始错误码，而是展示友好提示：
```
⚠️ 你所在的区域暂不支持该服务，请切换到支持的区域后重试。
```

Amount Display Rules

金额显示规则

Use appropriate precision: 2 decimals for high-value, significant digits for low-value
Market cap / liquidity in shorthand ($1.2B, $45M)
24h change with sign and color hint (+X% / -X%)

使用合适的精度：高价值资产保留2位小数，低价值资产保留有效数字
市值/流动性使用缩写（$1.2B、$45M）
24小时涨跌幅带正负号和颜色提示（+X% / -X%）

Global Notes

全局注意事项

Use contract address as primary identity — symbols can collide across tokens
```
communityRecognized = true
```
means listed on Top 10 CEX or community verified
The CLI resolves chain names automatically (e.g.,
```
ethereum
```
→
```
1
```
,
```
solana
```
→
```
501
```
)
EVM addresses must be all lowercase
The CLI handles authentication internally via environment variables — see Pre-flight Checks step 4 for authentication setup
Get your API token at https://6551.io/mcp

使用合约地址作为唯一标识 — 不同token的符号可能重复
```
communityRecognized = true
```
表示已上线头部10家CEX或通过社区验证
CLI会自动解析链名称（例如
```
ethereum
```
→
```
1
```
、
```
solana
```
→
```
501
```
）
EVM地址必须全部小写
CLI通过环境变量内部处理身份验证 — 身份验证设置请参考前置检查的第4步
你可以在https://6551.io/mcp获取API token