okx-dex-token

OKX DEX Token Info CLI

10 commands for token search, metadata, detailed pricing, rankings, liquidity pools, hot token lists, holder distribution, advanced token info, top trader analysis, and filtered trade history.

Pre-flight Checks

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.

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

2. 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:

   • Download the installer and its checksum file from the latest release tag:
     • 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"
   • Verify the installer's SHA256 against installer-checksums.txt. On mismatch, stop and warn — the installer may have been tampered with.
   • Execute: 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.
   • On other failures, point to https://github.com/okx/onchainos-skills.

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

   • Platform targets — 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
   • Hash command — macOS/Linux: shasum -a 256 ~/.local/bin/onchainos; Windows: (Get-FileHash "$env:USERPROFILE\.local\bin\onchainos.exe" -Algorithm SHA256).Hash.ToLower()

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

5. Do NOT auto-reinstall on command failures. Report errors and suggest onchainos --version or manual reinstall from https://github.com/okx/onchainos-skills.

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

Skill Routing

• For real-time prices / K-lines → use okx-dex-market
• For wallet PnL / personal DEX trade history → use okx-dex-market
• For swap execution → use okx-dex-swap
• For transaction broadcasting → use okx-onchain-gateway
• For meme token scanning (dev reputation, rug pull history, bundlers, new launches, similar tokens by same dev) → use okx-dex-trenches
• For market-wide smart money / whale / KOL signal alerts → use okx-dex-signal
• For per-token holder filtering by tag (whale, smart money, KOL, sniper) → use this skill (holders --tag-filter)
• For per-token risk analysis (dev rug pull count, holder concentration, creator info) → use this skill (advanced-info)

Keyword Glossary

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

Quickstart

# 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

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

Command Index

#	Command	Description
1	onchainos token search --query <query>	Search for tokens by name, symbol, or address
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	Get trending / top tokens
5	onchainos token holders --address <address>	Get token holder distribution (top 100, with optional tag filter)
6	onchainos token liquidity --address <address>	Get top 5 liquidity pools for a token
7	onchainos token hot-tokens	Get hot token list ranked by trending score or X mentions (max 100)
8	onchainos token advanced-info --address <address>	Get advanced token info (risk level, creator, dev stats, holder concentration)
9	onchainos token top-trader --address <address>	Get top traders / profit addresses for a token
10	onchainos token trades --address <address>	Get token DEX trade history with optional tag/wallet filters

Boundary: token vs market skill

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

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

Cross-Skill Workflows

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

Workflow A: Search → Research → Buy

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 steps
• chain from step 1 → reused in all subsequent steps
• decimal from step 1 or onchainos token info → needed for minimal unit conversion in swap

Workflow B: Discover Trending → Investigate → Trade

User: "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>

Workflow C: Token Verification Before Swap

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

Operation Flow

Step 1: Identify Intent

• Search for a token → onchainos token search
• Get token metadata → onchainos token info
• Get price + market cap + liquidity → onchainos token price-info
• View rankings → onchainos token trending
• View holder distribution → `onch

...