okx-dex-token by okx/onchainos-skills
npx skills add https://github.com/okx/onchainos-skills --skill okx-dex-token提供代币搜索、元数据、详细价格、排名、流动性池、热门代币列表、持币人分布、高级代币信息、顶级交易员分析、筛选交易历史、持币人聚类分析以及支持的链查询等 14 条命令。
每次运行任何 onchainos 命令前,请始终按顺序执行以下步骤。不要向用户回显常规命令输出;仅在安装、更新或处理失败时提供简短的状态更新。
解析最新稳定版本:从 GitHub API 获取最新的稳定发布标签:
curl -sSL "https://api.github.com/repos/okx/onchainos-skills/releases/latest"
将 tag_name 字段(例如 v1.0.5)提取到 LATEST_TAG 中。如果 API 调用失败且 onchainos 已在本地安装,则跳过步骤 2-3 并继续运行命令(用户可能离线或被限速;过时的二进制文件总比阻塞好)。如果 onchainos 未安装,则停止并告知用户检查网络连接或从 https://github.com/okx/onchainos-skills 手动安装。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
onchainos,或者 ~/.onchainos/last_check(Windows 上为 $env:USERPROFILE\.onchainos\last_check)的缓存时间超过 12 小时: * 从最新的发布标签下载安装程序及其校验和文件:
* **macOS/Linux**:`curl -sSL "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" -o /tmp/onchainos-install.sh"` `curl -sSL "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -o /tmp/installer-checksums.txt`
* **Windows**:`Invoke-WebRequest -Uri "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.ps1" -OutFile "$env:TEMP\onchainos-install.ps1"` `Invoke-WebRequest -Uri "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -OutFile "$env:TEMP\installer-checksums.txt"`
* 根据 `installer-checksums.txt` 验证安装程序的 SHA256。如果不匹配,则**停止**并警告——安装程序可能已被篡改。
* 执行:`sh /tmp/onchainos-install.sh`(或在 Windows 上为 `& "$env:TEMP\onchainos-install.ps1"`)。安装程序内部处理版本比较,仅在需要时下载二进制文件。
* 对于其他故障,请指向 <https://github.com/okx/onchainos-skills>。
3. 验证二进制文件完整性(每个会话一次):运行 onchainos --version 以获取已安装版本(例如 1.0.5 或 2.0.0-beta.0)。将已安装标签构造为 v<version>。为已安装版本的标签(不一定是 LATEST_TAG)下载 checksums.txt:curl -sSL "https://github.com/okx/onchainos-skills/releases/download/v<version>/checksums.txt" -o /tmp/onchainos-checksums.txt 查找平台目标,并将已安装二进制文件的 SHA256 与校验和进行比较。如果不匹配,则重新安装(步骤 2)并重新验证。如果仍然不匹配,则停止并警告。
* 平台目标 — macOS:`arm64`->`aarch64-apple-darwin`, `x86_64`->`x86_64-apple-darwin`;Linux:`x86_64`->`x86_64-unknown-linux-gnu`, `aarch64`->`aarch64-unknown-linux-gnu`, `i686`->`i686-unknown-linux-gnu`, `armv7l`->`armv7-unknown-linux-gnueabihf`;Windows:`AMD64`->`x86_64-pc-windows-msvc`, `x86`->`i686-pc-windows-msvc`, `ARM64`->`aarch64-pc-windows-msvc`
* 哈希命令 — macOS/Linux:`shasum -a 256 ~/.local/bin/onchainos`;Windows:`(Get-FileHash "$env:USERPROFILE\.local\bin\onchainos.exe" -Algorithm SHA256).Hash.ToLower()`
4. 检查技能版本漂移(每个会话一次):如果 onchainos --version 比此技能的 metadata.version 新,则显示一次性通知,告知该技能可能已过时,并建议用户通过其平台的方法重新安装技能。不要阻塞。
命令失败时不要自动重新安装。 报告错误并建议运行 onchainos --version 或从 https://github.com/okx/onchainos-skills 手动重新安装。
速率限制错误。 如果命令触发速率限制,共享的 API 密钥可能被限制。建议在 OKX 开发者门户 创建个人密钥。如果用户创建了 .env 文件,提醒他们将 .env 添加到 .gitignore。
okx-dex-marketokx-dex-marketokx-dex-swapokx-onchain-gatewayokx-dex-trenchesokx-dex-signalokx-dex-signalholders --tag-filter)advanced-info)用户可能使用中文加密俚语或平台特定术语。将它们映射到正确的命令:
| 中文 | 英文 / 平台术语 | 映射到 |
|---|---|---|
| 热门代币 / 热榜 | hot tokens, trending tokens | token hot-tokens |
| Trending榜 / 代币分排名 | trending score ranking | token hot-tokens --ranking-type 4 |
| Xmentioned榜 / 推特提及 / 社媒热度 | Twitter mentions ranking, social mentions | token hot-tokens --ranking-type 5 |
| 流动性池 / 资金池 | liquidity pools, top pools | token liquidity |
| 烧池子 / LP已销毁 | LP burned, burned liquidity | 通过 token hot-tokens --is-lp-burnt true 筛选 |
| 代币高级信息 / 风控 / 风险等级 | token risk, advanced info, risk level | token advanced-info |
| 貔貅盘 | honeypot | token advanced-info (tokenTags: "honeypot") |
| 内盘 / 内盘代币 | internal token, launch platform token | token advanced-info (isInternal) |
| 开发者跑路 / Rug Pull | rug pull, dev rug | token advanced-info (devRugPullTokenCount) |
| 盈利地址 / 顶级交易员 | top traders, profit addresses | token top-trader |
| 聪明钱 | smart money | token top-trader --tag-filter 3 或 token holders --tag-filter 3 |
| 巨鲸 | whale | token top-trader --tag-filter 4 或 token holders --tag-filter 4 |
| KOL | KOL / influencer | token top-trader --tag-filter 1 或 token holders --tag-filter 1 |
| 狙击手 | sniper | token top-trader --tag-filter 7 或 token holders --tag-filter 7 |
| 老鼠仓 / 可疑地址 | suspicious, insider trading | token top-trader --tag-filter 6 或 token holders --tag-filter 6 |
| 捆绑交易者 | bundle traders, bundlers | token top-trader --tag-filter 9 或 token holders --tag-filter 9 |
| 持币分布 / 持仓分布 | holder distribution | token holders |
| 前十持仓 / Top10集中度 | top 10 holder concentration | token hot-tokens --top10-hold-percent-min/max 或 token advanced-info (top10HoldPercent) |
| 开发者持仓 | dev holding percent | token hot-tokens --dev-hold-percent-min/max 或 token advanced-info (devHoldingPercent) |
| 净流入 | net inflow | token hot-tokens --inflow-min/max |
| 社区认可 | community recognized, verified | token search (communityRecognized 字段) |
| 持仓集中度 / 聚类分析 | holder cluster concentration, cluster analysis | token cluster-overview |
| 前100持仓概览 / Top100 | top 100 holder overview, top 100 behavior | token cluster-top-holders --range-filter 3 |
| 持仓集群 / 集群列表 | holder cluster list, cluster groups | token cluster-list |
| Rug Pull可能性 | rug pull probability, rug pull risk | token cluster-overview (rugPullPercent) |
| 新地址占比 | new address ratio, fresh wallet ratio | token cluster-overview (holderNewAddressPercent) |
| 同资金来源 | same funding source | token cluster-overview (holderSameFundSourcePercent) |
| 同创建时间地址占比 | same creation time address ratio | token cluster-overview (holderSameCreationTimePercent) |
| 支持的链 / cluster支持链 | supported chains for cluster | token cluster-supported-chains |
# 搜索代币
onchainos token search --query xETH --chains "ethereum,solana"
# 获取代币的前 5 个流动性池
onchainos token liquidity --address 0x1f16e03c1a5908818f47f6ee7bb16690b40d0671 --chain base
# 获取热门代币(按分数趋势,所有链)
onchainos token hot-tokens --ranking-type 4
# 获取 Solana 上 X 提及的热门代币
onchainos token hot-tokens --ranking-type 5 --chain solana
# 获取详细价格信息
onchainos token price-info --address 0xe7b000003a45145decf8a28fc755ad5ec5ea025a --chain xlayer
# Solana 上按交易量趋势是什么?
onchainos token trending --chains solana --sort-by 5 --time-frame 4
# 检查持币人分布
onchainos token holders --address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer
# 按聪明钱筛选持币人
onchainos token holders --address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer --tag-filter 3
# 获取高级代币信息(风险、创建者、开发者统计)
onchainos token advanced-info --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# 获取顶级交易员 / 盈利地址
onchainos token top-trader --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# 顶级 KOL 交易员
onchainos token top-trader --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana --tag-filter 1
# 持币人聚类集中度概览(Rug Pull %、新地址 %)
onchainos token cluster-overview --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# 前 100 名持币人行为(平均盈亏、平均成本、趋势)
onchainos token cluster-top-holders --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana --range-filter 3
# 持币人聚类列表(前 300 名持币人的分组)
onchainos token cluster-list --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# 检查哪些链支持持币人聚类分析
onchainos token cluster-supported-chains
CLI 接受人类可读的链名称(例如 ethereum、solana、xlayer)并自动解析它们。
| 链 | 名称 | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
---|---|---
1 | onchainos token search --query <query> [--chains <chains>] | 按名称、符号或地址搜索代币。接受 --chains(逗号分隔)或全局 --chain(单链)
2 | onchainos token info --address <address> | 获取代币基本信息(名称、符号、小数位数、Logo)
3 | onchainos token price-info --address <address> | 获取详细价格信息(价格、市值、流动性、交易量、24 小时变化)
4 | onchainos token trending [--chains <chains>] | 获取趋势 / 热门代币。接受 --chains(逗号分隔)或全局 --chain
5 | onchainos token holders --address <address> | 获取代币持币人分布(前 100 名,可选标签筛选)
6 | onchainos token liquidity --address <address> | 获取代币的前 5 个流动性池
7 | onchainos token hot-tokens | 获取按趋势分数或 X 提及排名的热门代币列表(最多 100 个)
8 | onchainos token advanced-info --address <address> | 获取高级代币信息(风险等级、创建者、开发者统计、持币人集中度)
9 | onchainos token top-trader --address <address> | 获取代币的顶级交易员 / 盈利地址
10 | onchainos token trades --address <address> | 获取代币 DEX 交易历史,可选标签/钱包筛选
11 | onchainos token cluster-overview --address <address> | 获取持币人聚类集中度概览(聚类级别、Rug Pull %、新地址 %)
12 | onchainos token cluster-top-holders --address <address> --range-filter <1|2|3> | 获取前 10/50/100 名持币人概览(平均盈亏、平均成本、趋势类型);1=前10,2=前50,3=前100
13 | onchainos token cluster-list --address <address> | 获取持币人聚类列表(前 300 名持币人的聚类分组及地址详情)
14 | onchainos token cluster-supported-chains | 获取支持持币人聚类分析的链
| 需求 | 使用此技能 (okx-dex-token) | 使用 okx-dex-market 替代 |
|---|---|---|
| 按名称/符号搜索代币 | onchainos token search | - |
| 代币元数据(小数位数、Logo) | onchainos token info | - |
| 价格 + 市值 + 流动性 + 多时间框架变化 | onchainos token price-info | - |
| 代币排名(趋势) | onchainos token trending | - |
| 持币人分布 | onchainos token holders | - |
| 按标签筛选持币人(KOL、巨鲸、聪明钱) | onchainos token holders --tag-filter | - |
| 代币的前 5 个流动性池 | onchainos token liquidity | - |
| 按趋势分数或 X 提及的热门代币 | onchainos token hot-tokens | - |
| 高级代币信息(风险、创建者、开发者统计) | onchainos token advanced-info | - |
| 顶级交易员 / 盈利地址 | onchainos token top-trader | - |
| 带标签/钱包筛选的代币交易历史 | onchainos token trades | - |
| 持币人聚类集中度(低/中/高、Rug Pull %、新地址 %) | onchainos token cluster-overview | - |
| 前 10/50/100 名持币人行为(平均盈亏、平均成本、趋势) | onchainos token cluster-top-holders | - |
| 持币人聚类分组(前 300 名,含地址详情) | onchainos token cluster-list | - |
| 原始实时价格(单一数值) | - | onchainos market price |
| K 线 / 蜡烛图 | - | onchainos market kline |
| 钱包盈亏概览 / DEX 交易历史 | - | onchainos market portfolio-* |
| 指数价格(多源聚合) | - | onchainos market index |
| 代币风险分析(开发者 Rug Pull 次数、持币人 %) | onchainos token advanced-info | - |
| Meme 代币开发者声誉 / Rug Pull 历史 | - | okx-dex-trenches → onchainos memepump token-dev-info |
| 捆绑/狙击手检测 | - | okx-dex-trenches → onchainos memepump token-bundle-info |
| 同一创建者的类似代币 | - | okx-dex-trenches → onchainos memepump similar-tokens |
| 全市场聪明钱 / 巨鲸 / KOL 警报 | - | okx-dex-signal → onchainos signal list |
经验法则:okx-dex-token = 代币发现和丰富分析(搜索、趋势、持币人、持币人筛选、市值、高级信息、顶级交易员、代币风险、筛选交易历史)。okx-dex-market = 原始价格源、图表、钱包盈亏。okx-dex-signal = 全市场聪明钱 / 巨鲸 / KOL 信号跟踪。okx-dex-trenches = Meme 代币扫描(开发者声誉、Rug Pull 历史、捆绑者分析、新发行)。
此技能是典型的入口点——用户通常从搜索/发现代币开始,然后进行兑换。
用户:"查找 BONK 代币,分析它,然后购买一些"
1. okx-dex-token onchainos token search --query BONK --chains solana → 获取 tokenContractAddress, chain, price
↓ tokenContractAddress
2. okx-dex-token onchainos token price-info --address <address> --chain solana → 市值, 流动性, volume24H, priceChange24H
3. okx-dex-token onchainos token holders --address <address> --chain solana → 前 100 名持币人分布
4. okx-dex-market onchainos market kline --address <address> --chain solana --bar 1H → 小时价格图表
↓ 用户决定购买
5. okx-dex-swap onchainos swap quote --from ... --to <address> --amount ... --chain solana
6. okx-dex-swap onchainos swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>
数据传递:
tokenContractAddress → 在所有后续步骤中重复使用chain → 在所有后续步骤中重复使用onchainos token info 的 decimal → 兑换中需要用于最小单位转换用户:"Solana 上有什么趋势?"
1. okx-dex-token onchainos token trending --chains solana --sort-by 5 --time-frame 4 → 按 24 小时交易量排名的顶级代币
↓ 用户选择一个代币
2. okx-dex-token onchainos token price-info --address <address> --chain solana → 详细分析
3. okx-dex-token onchainos token holders --address <address> --chain solana → 检查是否由巨鲸主导
4. okx-dex-market onchainos market kline --address <address> --chain solana → 用于可视化趋势的 K 线
↓ 用户决定交易
5. okx-dex-swap onchainos swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>
在兑换未知代币之前,始终验证:
1. okx-dex-token onchainos token search --query <name> → 查找代币
2. 检查 communityRecognized:
- true → 正常谨慎进行
- false → 警告用户风险
3. okx-dex-token onchainos token price-info --address <address> → 检查流动性:
- 流动性 < $10K → 警告高滑点风险
- 流动性 < $1K → 强烈不建议交易
4. okx-dex-swap onchainos swap quote ... → 检查 isHoneyPot 和 taxRate
5. 如果所有检查通过 → 继续兑换
用户:"聪明钱在买什么?检查是否安全并购买"
1. okx-dex-signal onchainos signal list --chain <chain> --wallet-type 1
→ 获取 tokenContractAddress + chainIndex
↓ 选择一个代币
2. okx-dex-token onchainos token price-info --address <address> --chain <chain> → 市值, 流动性, 24h 交易量
3. okx-dex-token onchainos token cluster-overview --address <address> --chain <chain>
→ 聚类集中度, Rug Pull %, 新地址 %
4. okx-dex-token onchainos token cluster-top-holders --address <address> --chain <chain> --range-filter 3
→ 前 100 名平均盈亏, 成本, 趋势方向
5. okx-dex-market onchainos market kline --address <address> --chain <chain> → 价格图表
↓ 用户决定购买
6. okx-dex-swap onchainos swap quote --from ... --to <address> --amount ... --chain <chain>
7. okx-dex-swap onchainos swap swap --from ... --to <address> --amount ... --chain <chain> --wallet <addr>
数据传递:步骤 1 的 baseTokenContractAddress + baseTokenChainIndex 输入到所有后续步骤中。
用户:"给我看最热门的代币,并检查是否有安全的可以购买"
1. okx-dex-token onchainos token hot-tokens --ranking-type 4 --chain solana
→ 按趋势分数排名的顶级代币;选择一个有趣的
↓ tokenContractAddress + chainIndex
2. okx-dex-token onchainos token price-info --address <address> --chain solana
→ 市值, 流动性, 24h 交易量, 价格变化
3. okx-dex-token onchainos token advanced-info --address <address> --chain solana
→ 风险等级, 貔貅盘检查, 开发者 Rug Pull 历史
4. okx-dex-token onchainos token cluster-overview --address <address> --chain solana
→ 集中度等级, Rug Pull %, 新地址 %, 同资金来源 %
5. okx-dex-token onchainos token cluster-top-holders --address <address> --chain solana --range-filter 3
→ 前 100 名持币人平均盈亏, 平均成本, 持有/卖出趋势
↓ 绿色标志 → 确认价格动量
6. okx-dex-market onchainos market kline --address <address> --chain solana --bar 15m --limit 48
→ 近期价格走势
↓ 用户决定购买
7. okx-dex-swap onchainos swap quote --from 11111111111111111111111111111111 --to <address> --amount <amount> --chain solana
8. okx-dex-swap onchainos swap swap --from 11111111111111111111111111111111 --to <address> --amount <amount> --chain solana --wallet <addr>
数据传递:步骤 1 的 tokenContractAddress 在步骤 2–8 中作为 <address> 重复使用;如果步骤 3 中 riskControlLevel >= 3 或步骤 4 中 clusterLevel = HIGH → 警告用户并在兑换前停止。
onchainos token searchonchainos token infoonchainos token price-infoonchainos token trendingonchainos token holdersonchainos token holders --tag-filteronchainos token liquidityonchainos token hot-tokensonchainos token advanced-infoonchainos token top-traderonchainos token cluster-overviewonchainos token cluster-top-holdersonchainos token cluster-listonchainos token cluster-supported-chains--chain xlayer,低 Gas,快速确认)作为默认值,然后询问用户偏好哪个链onchainos token search--ranking-type 默认为 4(Trending);使用 5 表示 X 提及排名--chain 以缩小范围--chains 默认为 "1,501"(Ethereum + Solana)--sort-by 默认为 5(交易量),--time-frame 默认为 4(24h)onchainos token cluster-supported-chains。communityRecognized 状态以进行信任信号传递显示结果后,根据刚刚执行的命令建议 2-3 个相关的后续操作:
| 刚刚调用 | 建议 |
|---|---|
token search | 1. 查看详细分析(市值、流动性) → onchainos token price-info(此技能) 2. 查看价格图表 → okx-dex-market 3. 购买/兑换此代币 → okx-dex-swap |
token info | 1. 查看价格和市场数据 → onchainos token price-info(此技能) 2. 检查持币人分布 → onchainos token holders(此技能) |
token price-info | 1. 查看 K 线图表 → okx-dex-market 2. 检查持币人分布 → onchainos token holders(此技能) 3. 购买/兑换此代币 → okx-dex-swap |
token trending | 1. 查看特定代币的详细信息 → onchainos token price-info(此技能) 2. 查看价格图表 → okx-dex-market 3. 购买趋势代币 → okx-dex-swap |
token holders | 1. 查看价格趋势 → okx-dex-market 2. 购买/兑换此代币 → okx-dex-swap 3. 检查高级信息 → onchainos token advanced-info(此技能) |
token liquidity | 1. 查看价格图表 → okx-dex-market 2. 购买/兑换此代币 → okx-dex-swap 3. 检查持币人 → onchainos token holders(此技能) |
token hot-tokens | 1. 查看热门代币的详细信息 → onchainos token price-info(此技能) 2. 检查流动性池 → onchainos token liquidity(此技能) 3. 购买热门代币 → okx-dex-swap |
token advanced-info | 1. 查看持币人 → onchainos token holders(此技能) 2. 查看顶级交易员 → onchainos token top-trader(此技能) 3. 购买/兑换此代币 → okx-dex-swap |
token top-trader | 1. 查看高级信息 → onchainos token advanced-info(此技能) 2. 查看持币人分布 → onchainos token holders(此技能) 3. 购买/兑换此代币 → okx-dex-swap |
token trades | 1. 查看顶级交易员 → onchainos token top-trader(此技能) 2. 查看价格图表 → okx-dex-market 3. 购买/兑换此代币 → okx-dex-swap |
token cluster-overview | 1. 深入查看顶级持币人行为 → onchainos token cluster-top-holders(此技能) 2. 查看聚类分组 → onchainos token cluster-list(此技能) 3. 检查高级信息 → onchainos token advanced-info(此技能) |
token cluster-top-holders | 1. 查看聚类分组详情 → onchainos token cluster-list(此技能) 2. 查看持币人分布 → onchainos token holders(此技能) |
token cluster-list | 1. 查看价格图表 → okx-dex-market 2. 检查顶级交易员 → onchainos token top-trader(此技能) |
以对话方式呈现,例如:"您想查看价格图表还是检查持币人分布?"——永远不要向用户暴露技能名称或端点路径。
有关所有 14 条命令的详细参数表、返回字段架构和使用示例,请查阅:
references/cli-reference.md — 完整的 CLI 命令参考,包含参数、返回字段和示例要搜索特定命令的详细信息:grep -n "onchainos token <command>" references/cli-reference.md
这些规则是强制性的。请勿跳过或绕过。
communityRecognized 仅用于信息参考。 它表示代币在 Top 10 CEX 上市或经过社区验证,但这不能保证代币的安全性、合法性或投资适用性。始终在上下文中显示此状态,而不是作为信任背书。communityRecognized = false 时,显示醒目的警告:"此代币未经社区认可。请谨慎操作——在交易前独立验证合约地址。"liquidity 可用时:
* < $10K:警告高滑点风险,并要求用户在继续兑换前确认。
* < $1K:强烈警告交易可能导致重大损失。仅在用户明确确认后继续。communityRecognized = false — 警告用户风险⚠️ 您所在区域的服务不可用。请切换到支持的区域并重试。14 commands for token search, metadata, detailed pricing, rankings, liquidity pools, hot token lists, holder distribution, advanced token info, top trader analysis, filtered trade history, holder cluster analysis, and supported chain lookup.
Every time before running any onchainos 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.
Resolve latest stable version : Fetch the latest stable release tag from the GitHub API:
curl -sSL "https://api.github.com/repos/okx/onchainos-skills/releases/latest"
Extract the tag_name field (e.g., v1.0.5) into LATEST_TAG. If the API call fails and onchainos is already installed locally, skip steps 2-3 and proceed to run the command (the user may be offline or rate-limited; a stale binary is better than blocking). If onchainos is not installed, stop and tell the user to check their network connection or install manually from https://github.com/okx/onchainos-skills.
Install or update : If onchainos is not found, or if the cache at ~/.onchainos/last_check ($env:USERPROFILE\.onchainos\last_check on Windows) is older than 12 hours:
curl -sSL "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" -o /tmp/onchainos-install.sh curl -sSL "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -o /tmp/installer-checksums.txtInvoke-WebRequest -Uri "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.ps1" -OutFile "$env:TEMP\onchainos-install.ps1" okx-dex-marketokx-dex-marketokx-dex-swapokx-onchain-gatewayokx-dex-trenchesokx-dex-signalokx-dex-signalholders --tag-filter)Users may use Chinese crypto slang or platform-specific terms. Map them to the correct commands:
| Chinese | English / Platform Terms | Maps To |
|---|---|---|
| 热门代币 / 热榜 | hot tokens, trending tokens | token hot-tokens |
| Trending榜 / 代币分排名 | trending score ranking | token hot-tokens --ranking-type 4 |
| Xmentioned榜 / 推特提及 / 社媒热度 | Twitter mentions ranking, social mentions | token hot-tokens --ranking-type 5 |
| 流动性池 / 资金池 | liquidity pools, top pools | token liquidity |
| 烧池子 / LP已销毁 | LP burned, burned liquidity | filter via |
# Search token
onchainos token search --query xETH --chains "ethereum,solana"
# Get top 5 liquidity pools for a token
onchainos token liquidity --address 0x1f16e03c1a5908818f47f6ee7bb16690b40d0671 --chain base
# Get hot tokens (trending by score, all chains)
onchainos token hot-tokens --ranking-type 4
# Get X-mentioned hot tokens on Solana
onchainos token hot-tokens --ranking-type 5 --chain solana
# Get detailed price info
onchainos token price-info --address 0xe7b000003a45145decf8a28fc755ad5ec5ea025a --chain xlayer
# What's trending on Solana by volume?
onchainos token trending --chains solana --sort-by 5 --time-frame 4
# Check holder distribution
onchainos token holders --address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer
# Filter holders by smart money
onchainos token holders --address 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --chain xlayer --tag-filter 3
# Get advanced token info (risk, creator, dev stats)
onchainos token advanced-info --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# Get top traders / profit addresses
onchainos token top-trader --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# Top KOL traders
onchainos token top-trader --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana --tag-filter 1
# Holder cluster concentration overview (rug pull %, new addresses %)
onchainos token cluster-overview --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# Top 100 holder behavior (avg PnL, avg cost, trend)
onchainos token cluster-top-holders --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana --range-filter 3
# Holder cluster list (groups of top 300 holders)
onchainos token cluster-list --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
# Check which chains support holder cluster analysis
onchainos token cluster-supported-chains
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 |
---|---|---
1 | onchainos token search --query <query> [--chains <chains>] | Search for tokens by name, symbol, or address. Accepts --chains (comma-separated) or global --chain (single chain)
2 | onchainos token info --address <address> | Get token basic info (name, symbol, decimals, logo)
3 | onchainos token price-info --address <address> | Get detailed price info (price, market cap, liquidity, volume, 24h change)
4 | onchainos token trending [--chains <chains>] | Get trending / top tokens. Accepts --chains (comma-separated) or global --chain
5 | onchainos token holders --address <address> | Get token holder distribution (top 100, with optional tag filter)
6 | | Get top 5 liquidity pools for a token
7 | | Get hot token list ranked by trending score or X mentions (max 100)
8 | | Get advanced token info (risk level, creator, dev stats, holder concentration)
9 | | Get top traders / profit addresses for a token
10 | | Get token DEX trade history with optional tag/wallet filters
11 | | Get holder cluster concentration overview (cluster level, rug pull %, new address %)
12 | | Get top 10/50/100 holder overview (avg PnL, avg cost, trend type); 1=top10, 2=top50, 3=top100
13 | | Get holder cluster list (clusters of top 300 holders with address details)
14 | | Get chains supported by holder cluster analysis
| Need | Use this skill (okx-dex-token) | Use okx-dex-market instead |
|---|---|---|
| Search token by name/symbol | onchainos token search | - |
| Token metadata (decimals, logo) | onchainos token info | - |
| Price + market cap + liquidity + multi-timeframe change | onchainos token price-info | - |
| Token ranking (trending) | onchainos token trending |
Rule of thumb : okx-dex-token = token discovery & enriched analytics (search, trending, holders, holder filtering, market cap, advanced info, top traders, token risk, filtered trade history). okx-dex-market = raw price feeds, charts, wallet PnL. okx-dex-signal = market-wide smart money / whale / KOL signal tracking. okx-dex-trenches = meme pump scanning (dev reputation, rug pull history, bundler analysis, new launches).
This skill is the typical entry point — users often start by searching/discovering tokens, then proceed to swap.
User: "Find BONK token, analyze it, then buy some"
1. okx-dex-token onchainos token search --query BONK --chains solana → get tokenContractAddress, chain, price
↓ tokenContractAddress
2. okx-dex-token onchainos token price-info --address <address> --chain solana → market cap, liquidity, volume24H, priceChange24H
3. okx-dex-token onchainos token holders --address <address> --chain solana → top 100 holders distribution
4. okx-dex-market onchainos market kline --address <address> --chain solana --bar 1H → hourly price chart
↓ user decides to buy
5. okx-dex-swap onchainos swap quote --from ... --to <address> --amount ... --chain solana
6. okx-dex-swap onchainos swap swap --from ... --to <address> --amount ... --chain solana --wallet <addr>
Data handoff :
tokenContractAddress from step 1 → reused in all subsequent stepschain from step 1 → reused in all subsequent stepsdecimal from step 1 or onchainos token info → needed for minimal unit conversion in swapUser: "What's trending on Solana?"
1. okx-dex-token onchainos token trending --chains solana --sort-by 5 --time-frame 4 → top tokens by 24h volume
↓ user picks a token
2. okx-dex-token onchainos token price-info --address <address> --chain solana → detailed analytics
3. okx-dex-token onchainos token holders --address <address> --chain solana → check if whale-dominated
4. okx-dex-market onchainos market kline --address <address> --chain solana → K-line for visual trend
↓ user decides to trade
5. okx-dex-swap onchainos swap swap --from ... --to ... --amount ... --chain solana --wallet <addr>
Before swapping an unknown token, always verify:
1. okx-dex-token onchainos token search --query <name> → find token
2. Check communityRecognized:
- true → proceed with normal caution
- false → warn user about risk
3. okx-dex-token onchainos token price-info --address <address> → check liquidity:
- liquidity < $10K → warn about high slippage risk
- liquidity < $1K → strongly discourage trade
4. okx-dex-swap onchainos swap quote ... → check isHoneyPot and taxRate
5. If all checks pass → proceed to swap
User: "What is smart money buying? Check if it's safe and buy"
1. okx-dex-signal onchainos signal list --chain <chain> --wallet-type 1
→ get tokenContractAddress + chainIndex
↓ pick a token
2. okx-dex-token onchainos token price-info --address <address> --chain <chain> → market cap, liquidity, 24h volume
3. okx-dex-token onchainos token cluster-overview --address <address> --chain <chain>
→ cluster concentration, rug pull %, new address %
4. okx-dex-token onchainos token cluster-top-holders --address <address> --chain <chain> --range-filter 3
→ top 100 avg PnL, cost, trend direction
5. okx-dex-market onchainos market kline --address <address> --chain <chain> → price chart
↓ user decides to buy
6. okx-dex-swap onchainos swap quote --from ... --to <address> --amount ... --chain <chain>
7. okx-dex-swap onchainos swap swap --from ... --to <address> --amount ... --chain <chain> --wallet <addr>
Data handoff : baseTokenContractAddress + baseTokenChainIndex from step 1 feed into all subsequent steps.
User: "Show me the hottest tokens and check if any are safe to buy"
1. okx-dex-token onchainos token hot-tokens --ranking-type 4 --chain solana
→ top tokens by trending score; pick an interesting one
↓ tokenContractAddress + chainIndex
2. okx-dex-token onchainos token price-info --address <address> --chain solana
→ market cap, liquidity, 24h volume, price change
3. okx-dex-token onchainos token advanced-info --address <address> --chain solana
→ risk level, honeypot check, dev rug pull history
4. okx-dex-token onchainos token cluster-overview --address <address> --chain solana
→ concentration level, rug pull %, new address %, same-funding %
5. okx-dex-token onchainos token cluster-top-holders --address <address> --chain solana --range-filter 3
→ top 100 holder avg PnL, avg cost, hold/sell trend
↓ green flags → confirm price momentum
6. okx-dex-market onchainos market kline --address <address> --chain solana --bar 15m --limit 48
→ recent price action
↓ user decides to buy
7. okx-dex-swap onchainos swap quote --from 11111111111111111111111111111111 --to <address> --amount <amount> --chain solana
8. okx-dex-swap onchainos swap swap --from 11111111111111111111111111111111 --to <address> --amount <amount> --chain solana --wallet <addr>
Data handoff : tokenContractAddress from step 1 reused as <address> in steps 2–8; if riskControlLevel >= 3 in step 3 or clusterLevel = HIGH in step 4 → warn user and stop before swap.
onchainos token searchonchainos token infoonchainos token price-infoonchainos token trendingonchainos token holdersonchainos token holders --tag-filteronchainos token liquidityonchainos token hot-tokensonchainos token advanced-info--chain xlayer, low gas, fast confirmation) as the default, then ask which chain the user prefersonchainos token search first--ranking-type defaults to 4 (Trending); use 5 for X-mentioned rankings--chain to narrow--chains defaults to "1,501" (Ethereum + Solana)--sort-by defaults to 5 (volume), defaults to (24h)communityRecognized status for trust signalingAfter 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) → onchainos token price-info (this skill) 2. View price chart → okx-dex-market 3. Buy/swap this token → okx-dex-swap |
token info | 1. View price and market data → onchainos token price-info (this skill) 2. Check holder distribution → onchainos token holders (this skill) |
token price-info |
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.
For detailed parameter tables, return field schemas, and usage examples for all 14 commands, consult:
references/cli-reference.md — Full CLI command reference with params, return fields, and examplesTo search for specific command details: grep -n "onchainos token <command>" references/cli-reference.md
These rules are mandatory. Do NOT skip or bypass them.
communityRecognized is informational only. It indicates the token is listed on a Top 10 CEX or is community-verified, but this is not a guarantee of token safety, legitimacy, or investment suitability. Always display this status with context, not as a trust endorsement.communityRecognized = false, display a prominent warning: "This token is not community-recognized. Exercise caution — verify the contract address independently before trading."liquidity is available:
communityRecognized = false — warn user about risk⚠️ Service is not available in your region. Please switch to a supported region and try again.advanced-info, translate tokenTags values into human-readable language: honeypot→貔貅盘, lowLiquidity→低流动性, devHoldingStatusSellAll→开发者已全部卖出, smartMoneyBuy→聪明钱买入, communityRecognized→社区认可, dexBoost→Boost活动, devBurnToken→开发者燃烧代币, devAddLiquidity→开发者添加流动性. Never dump raw tag strings to the user.riskControlLevel values: =未定义, =低风险, =中风险, =中高风险, =高风险, =高风险(手动配置)Weekly Installs
3.1K
Repository
GitHub Stars
173
First Seen
Feb 28, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex3.0K
opencode3.0K
cursor3.0K
github-copilot3.0K
gemini-cli3.0K
amp3.0K
24,400 周安装
Invoke-WebRequest -Uri "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -OutFile "$env:TEMP\installer-checksums.txt"installer-checksums.txt. On mismatch, stop and warn — the installer may have been tampered with.sh /tmp/onchainos-install.sh (or & "$env:TEMP\onchainos-install.ps1" on Windows). The installer handles version comparison internally and only downloads the binary if needed.Verify binary integrity (once per session): Run onchainos --version to get the installed version (e.g., 1.0.5 or 2.0.0-beta.0). Construct the installed tag as v<version>. Download checksums.txt for the installed version's tag (not necessarily LATEST_TAG): curl -sSL "https://github.com/okx/onchainos-skills/releases/download/v<version>/checksums.txt" -o /tmp/onchainos-checksums.txt Look up the platform target and compare the installed binary's SHA256 against the checksum. On mismatch, reinstall (step 2) and re-verify. If still mismatched, stop and warn.
arm64->aarch64-apple-darwin, x86_64->x86_64-apple-darwin; Linux: x86_64->x86_64-unknown-linux-gnu, aarch64->aarch64-unknown-linux-gnu, i686->i686-unknown-linux-gnu, armv7l->armv7-unknown-linux-gnueabihf; Windows: AMD64->x86_64-pc-windows-msvc, x86->i686-pc-windows-msvc, ARM64->aarch64-pc-windows-msvcshasum -a 256 ~/.local/bin/onchainos; Windows: (Get-FileHash "$env:USERPROFILE\.local\bin\onchainos.exe" -Algorithm SHA256).Hash.ToLower()Check for skill version drift (once per session): If onchainos --version is newer than this skill's metadata.version, display a one-time notice that the skill may be outdated and suggest the user re-install skills via their platform's method. Do not block.
Do NOT auto-reinstall on command failures. Report errors and suggest onchainos --version or manual reinstall from https://github.com/okx/onchainos-skills.
Rate limit errors. If a command hits rate limits, the shared API key may be throttled. Suggest creating a personal key at the OKX Developer Portal. If the user creates a .env file, remind them to add .env to .gitignore.
advanced-infotoken hot-tokens --is-lp-burnt true| 代币高级信息 / 风控 / 风险等级 | token risk, advanced info, risk level | token advanced-info |
| 貔貅盘 | honeypot | token advanced-info (tokenTags: "honeypot") |
| 内盘 / 内盘代币 | internal token, launch platform token | token advanced-info (isInternal) |
| 开发者跑路 / Rug Pull | rug pull, dev rug | token advanced-info (devRugPullTokenCount) |
| 盈利地址 / 顶级交易员 | top traders, profit addresses | token top-trader |
| 聪明钱 | smart money | token top-trader --tag-filter 3 or token holders --tag-filter 3 |
| 巨鲸 | whale | token top-trader --tag-filter 4 or token holders --tag-filter 4 |
| KOL | KOL / influencer | token top-trader --tag-filter 1 or token holders --tag-filter 1 |
| 狙击手 | sniper | token top-trader --tag-filter 7 or token holders --tag-filter 7 |
| 老鼠仓 / 可疑地址 | suspicious, insider trading | token top-trader --tag-filter 6 or token holders --tag-filter 6 |
| 捆绑交易者 | bundle traders, bundlers | token top-trader --tag-filter 9 or token holders --tag-filter 9 |
| 持币分布 / 持仓分布 | holder distribution | token holders |
| 前十持仓 / Top10集中度 | top 10 holder concentration | token hot-tokens --top10-hold-percent-min/max or token advanced-info (top10HoldPercent) |
| 开发者持仓 | dev holding percent | token hot-tokens --dev-hold-percent-min/max or token advanced-info (devHoldingPercent) |
| 净流入 | net inflow | token hot-tokens --inflow-min/max |
| 社区认可 | community recognized, verified | token search (communityRecognized field) |
| 持仓集中度 / 聚类分析 | holder cluster concentration, cluster analysis | token cluster-overview |
| 前100持仓概览 / Top100 | top 100 holder overview, top 100 behavior | token cluster-top-holders --range-filter 3 |
| 持仓集群 / 集群列表 | holder cluster list, cluster groups | token cluster-list |
| Rug Pull可能性 | rug pull probability, rug pull risk | token cluster-overview (rugPullPercent) |
| 新地址占比 | new address ratio, fresh wallet ratio | token cluster-overview (holderNewAddressPercent) |
| 同资金来源 | same funding source | token cluster-overview (holderSameFundSourcePercent) |
| 同创建时间地址占比 | same creation time address ratio | token cluster-overview (holderSameCreationTimePercent) |
| 支持的链 / cluster支持链 | supported chains for cluster | token cluster-supported-chains |
8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
onchainos token liquidity --address <address>onchainos token hot-tokensonchainos token advanced-info --address <address>onchainos token top-trader --address <address>onchainos token trades --address <address>onchainos token cluster-overview --address <address>onchainos token cluster-top-holders --address <address> --range-filter <1|2|3>onchainos token cluster-list --address <address>onchainos token cluster-supported-chains| - |
| Holder distribution | onchainos token holders | - |
| Holders filtered by tag (KOL, whale, smart money) | onchainos token holders --tag-filter | - |
| Top 5 liquidity pools for a token | onchainos token liquidity | - |
| Hot tokens by trending score or X mentions | onchainos token hot-tokens | - |
| Advanced token info (risk, creator, dev stats) | onchainos token advanced-info | - |
| Top traders / profit addresses | onchainos token top-trader | - |
| Token trade history with tag/wallet filter | onchainos token trades | - |
| Holder cluster concentration (LOW/MEDIUM/HIGH, rug pull %, new address %) | onchainos token cluster-overview | - |
| Top 10/50/100 holder behavior (avg PnL, avg cost, trend) | onchainos token cluster-top-holders | - |
| Holder cluster groups (top 300, with address details) | onchainos token cluster-list | - |
| Raw real-time price (single value) | - | onchainos market price |
| K-line / candlestick chart | - | onchainos market kline |
| Wallet PnL overview / DEX transaction history | - | onchainos market portfolio-* |
| Index price (multi-source aggregate) | - | onchainos market index |
| Token risk analysis (dev rug pull count, holder %) | onchainos token advanced-info | - |
| Meme token dev reputation / rug pull history | - | okx-dex-trenches → onchainos memepump token-dev-info |
| Bundle/sniper detection | - | okx-dex-trenches → onchainos memepump token-bundle-info |
| Similar tokens by same creator | - | okx-dex-trenches → onchainos memepump similar-tokens |
| Market-wide smart money / whale / KOL alerts | - | okx-dex-signal → onchainos signal list |
onchainos token top-traderonchainos token cluster-overviewonchainos token cluster-top-holdersonchainos token cluster-listonchainos token cluster-supported-chains--time-frame4onchainos token cluster-supported-chains first before calling cluster-overview / cluster-top-holders / cluster-list.1. View K-line chart → okx-dex-market 2. Check holder distribution → onchainos token holders (this skill) 3. Buy/swap this token → okx-dex-swap |
token trending | 1. View details for a specific token → onchainos token price-info (this skill) 2. View price chart → okx-dex-market 3. Buy a trending token → okx-dex-swap |
token holders | 1. View price trend → okx-dex-market 2. Buy/swap this token → okx-dex-swap 3. Check advanced info → onchainos token advanced-info (this skill) |
token liquidity | 1. View price chart → okx-dex-market 2. Buy/swap this token → okx-dex-swap 3. Check holders → onchainos token holders (this skill) |
token hot-tokens | 1. View details for a hot token → onchainos token price-info (this skill) 2. Check liquidity pools → onchainos token liquidity (this skill) 3. Buy a hot token → okx-dex-swap |
token advanced-info | 1. View holders → onchainos token holders (this skill) 2. View top traders → onchainos token top-trader (this skill) 3. Buy/swap this token → okx-dex-swap |
token top-trader | 1. View advanced info → onchainos token advanced-info (this skill) 2. View holder distribution → onchainos token holders (this skill) 3. Buy/swap this token → okx-dex-swap |
token trades | 1. View top traders → onchainos token top-trader (this skill) 2. View price chart → okx-dex-market 3. Buy/swap this token → okx-dex-swap |
token cluster-overview | 1. Drill into top holder behavior → onchainos token cluster-top-holders (this skill) 2. View cluster groups → onchainos token cluster-list (this skill) 3. Check advanced info → onchainos token advanced-info (this skill) |
token cluster-top-holders | 1. View cluster group details → onchainos token cluster-list (this skill) 2. View holder distribution → onchainos token holders (this skill) |
token cluster-list | 1. View price chart → okx-dex-market 2. Check top traders → onchainos token top-trader (this skill) |
012345communityRecognized = true means listed on Top 10 CEX or community verifiedethereum → 1, solana → 501)