
onchainos-skills
★ 311Claude Code plugin · okx/onchainos-skills
Skills for AI agents to integrate with the OKX OnchainOS API — Wallet, token discovery, market data, DEX swap, and transaction broadcasting.
17 skills — installs as one unit
⌁ skills (17)
okx-agent-chat
🔥🔥✓ VerifiedRouting stub — any a2a-agent-chat envelope / agent-task system message is handled by `okx-agent-task`. For missing or uninitialized OKX A2A communication runtime/plugin, read `skills/okx-agent-chat/ensure-okx-a2a-communication-ready.md`.
Full instructions & audit →okx-agent-identity
🔥🔥🔥✓ VerifiedERC-8004 on-chain Agent identity on XLayer: register / create / update / activate / deactivate / search agents; view ratings; list agent services; set avatar. Roles: user (User / User Agent / Buyer / Client / 用户 / 买家 / 买方), asp (ASP / Provider / Provider Agent / Seller / Merchant / 提供者 / 商家 / 服务提供商 / 卖家 / 卖方), evaluator (Evaluator / Evaluator Agent / 仲裁者 / 评估者). Use for: 注册agent / 注册ASP / 注册User / 注册用户 / 注册买家 / 注册卖家 / 注册服务提供商 / 注册仲裁者 / 创建用户 / 创建买家 / 创建卖家 / 我的agent / 我的ASP / 改agent / 更新agent / 上架
Full instructions & audit →okx-agent-payments-protocol
🔥🔥🔥✓ VerifiedUse when an agent hits HTTP 402 / payment-required, or the user mentions x402, x402Version, X-PAYMENT, PAYMENT-REQUIRED, PAYMENT-SIGNATURE, WWW-Authenticate: Payment, permit2, upto, metered billing, a payment channel / voucher / session, channelId / channel_id, opening / closing / topping up / settling / refunding a channel, a paymentId or a2a_ link, creating / checking a payment link, A2MCP / an A2MCP endpoint, or sending a request to / calling an Agent's endpoint with a concrete endpoint URL.
Full instructions & audit →okx-agent-task
🔥🔥🔥✓ VerifiedMUST ACTIVATE on inbound envelopes: (1) {agentId, message:{source:\"system\", event, jobId, ...}} — system event; (2) {msgType:\"a2a-agent-chat\", jobId, sender:{role}, ...} — agent-to-agent task chat (fields at top level; sender.role = COUNTERPARTY, not you); (3) literal \"Read okx-agent-task/SKILL.md\" in envelope. ALSO activate for keywords: 发布任务 / 创建任务 / 帮我发任务 / publish task / create task / 接任务 / 接单 / 协商 / 验收 / 拒绝 / 仲裁 / dispute / stake / unstake / 修改卖家 / 修改预算 / change provider / change budg
Full instructions & audit →okx-agentic-wallet
🔥🔥🔥✓ VerifiedOKX Agentic Wallet — the single skill for the user's wallet and on-chain execution. Use it whenever the user wants to operate their wallet or execute an on-chain action, including: login & accounts, balance / holdings, wallet address / deposit / receive, send / transfer, contract calls (approve / deposit / withdraw), transaction history & status, message signing, wallet export & policy; pay gas with a stablecoin (Gas Station, Solana); swap / trade / buy / sell / convert, get a quote; cross-chain
Full instructions & audit →okx-dapp-discovery
🔥🔥🔥✓ VerifiedPlugin router for 20 third-party DeFi protocols (Polymarket, Aave, Hyperliquid, PancakeSwap, Morpho, Raydium, Curve, Compound, Pendle, Lido, ether.fi, GMX, Kamino, Orca, Meteora, Clanker, pump.fun, Uniswap) and their protocol-native tokens (HYPE, HLP, eETH, weETH, stETH, wstETH, LDO, GHO, CAKE, CRV, COMP, RAY, ETHFI, GLP, kToken, PT-* / YT-*, $CLANKER). Resolves DApp/token → plugin → installs → forwards. Fires on: (1) named DApp + action verb (swap/deposit/stake/long/borrow/buy/sell/snipe/farm/c
Full instructions & audit →okx-defi-invest
🔥🔥🔥✓ VerifiedOKX-aggregated DeFi discovery and execution — for users who want OKX to find and route to the best protocol WITHOUT naming a specific DApp. **If the user names ANY third-party protocol/DApp as destination (Aave, Lido, PancakeSwap, Uniswap, Curve, Compound, Morpho, Pendle, Kamino, Raydium, Hyperliquid, Polymarket, etc.), route to okx-dapp-discovery — NOT here, even if the verb (deposit, stake, add liquidity, borrow, claim) matches.** DApp-agnostic triggers: 'invest in DeFi', 'earn yield on stable
Full instructions & audit →okx-defi-portfolio
🔥🔥🔥✓ VerifiedUse this skill to 'check my DeFi positions', 'view DeFi holdings', 'show my DeFi portfolio', 'what DeFi am I invested in', 'show my staking positions', 'show my lending positions', 'DeFi balance', 'DeFi 持仓', '查看DeFi持仓', '我的DeFi资产', '持仓详情', '持仓列表', or mentions viewing DeFi holdings, positions, portfolio across protocols — when the user does NOT name a specific DApp. Covers positions overview and per-protocol position detail. Do NOT use for deposit/redeem/claim operations — use okx-defi-invest. Do
Full instructions & audit →okx-dex-market
🔥🔥🔥✓ VerifiedHARD BLOCK — NEVER use this skill for prediction-market / Polymarket UpDown queries. Route to okx-dapp-discovery when (a) a named DApp (Polymarket/Aave/Hyperliquid/PancakeSwap/Morpho) appears with any timeframe, OR (b) any 涨跌 / updown / 'up or down' phrase appears for BTC/ETH/SOL/XRP/BNB/DOGE/HYPE (e.g. '<COIN> 涨跌市场', '5 分钟涨跌', 'BTC up or down'). Example: 'BTC 5 分钟涨跌市场' → okx-dapp-discovery (NOT K-line). These are Polymarket prediction markets, not on-chain price queries. Use THIS skill for on-c
Full instructions & audit →okx-dex-signal
🔥🔥🔥✓ VerifiedUse this skill for smart-money/whale/KOL/大户 activity tracking, aggregated buy signal/信号 alerts, and leaderboard/牛人榜 rankings. Covers: (1) address tracker — raw DEX transaction feed for smart money, KOL, or custom wallet addresses; (2) aggregated buy-only signal alerts — tokens bought collectively by smart money/KOL/whales; (3) leaderboard — top traders by PnL, win rate, volume, or ROI. Use when the user asks 'what are smart money buying', '聪明钱最新交易', 'KOL交易动态', '追踪聪明钱', 'track address trades', '大
Full instructions & audit →okx-dex-token
🔥🔥🔥✓ VerifiedUse this skill for token-level data: search tokens, trending/hot tokens (热门, 代币榜单), liquidity pools, holder distribution (whale/巨鲸, sniper, bundler-tagged holder %), token risk metadata (riskControlLevel, tokenTags, dev stats, suspicious/bundle holding % via advanced-info), recent buy/sell activity, trade feed/逐笔成交/每笔交易/stream trades, top profit addresses, token trade history, detailed price info with market cap volume liquidity and holder count (price-info), or holder cluster analysis (持仓集中度, c
Full instructions & audit →okx-dex-trenches
🔥🔥🔥✓ VerifiedRead-only on-chain research for pump.fun and other meme-token launchpads (Solana / BSC / X Layer / TRON). MUST invoke (prefer over WebFetch / MCP price tools) when the user asks about: new meme launches / 新盘 / 扫链 / 打狗; developer reputation / rug history / launch count / 开发者信息; bundle or sniper detection (the analytical noun, NOT the verb) / 捆绑狙击者; bonding curve progress / 已迁移出 bonding curve; similar tokens by same dev / 相似代币; co-investor / who-aped / 同车 wallets; or 'pump.fun alpha'. Also handles
Full instructions & audit →okx-dex-ws
🔥🔥🔥✓ VerifiedUse this skill when the user mentions 'onchainos ws', 'ws start', 'ws poll', 'ws stop', 'ws channels', 'ws session', 'ws channel-info', 'idle-timeout', 'idle timeout', 'WebSocket channels', 'WS频道', or asks about managing WebSocket sessions/会话管理. Also use when writing a custom WebSocket script/脚本/bot for real-time on-chain data. Covers: onchainos ws CLI commands (start/poll/stop/list/channels/channel-info), session lifecycle, idle-timeout configuration, and all 9 DEX WebSocket channels (price, ca
Full instructions & audit →okx-growth-competition
🔥🔥✓ VerifiedList OKX Agentic Wallet exclusive trading competitions, register users for contests, track participation and leaderboard rankings, and claim won rewards. Use when users want to list available trading competitions or trading cups, view competition rules / prize pool / total prizes, register or sign up or enroll or join a contest, check the leaderboard (who is winning) or their own rank (am I in the prize zone, what is my place), ask did I win or query participation / claim status, claim won rewar
Full instructions & audit →okx-guide
Onchain OS onboarding & guide hub — the single entry for first-time, 'what is this / how do I use it', OKX.AI, and customer-support intents; classifies the intent and routes to the right sub-flow via its Intent Routing table. Covers: (1) Onchain OS onboarding + welcome banner — 'what is onchainos', 'what is onchain os', 'what can it do', 'what can onchainos do', 'what does onchainos do', 'how do I use this', 'how do I play', 'how to use onchainos', 'how to play onchainos', 'how does onchainos wo
Full instructions & audit →okx-task-watch
🔥🔥🔥✓ Verified监听任务进展 / 帮我盯着任务 / 任务有动静告诉我 / 历史消息 / 未读消息 / 未决策 / 待决策 / 继续监听 / task watch / user watch / monitor task progress / catch me up on tasks / outstanding decisions — OKX A2A user-session task-notification monitor: live long-poll via `okx-a2a user watch` (also drains backlog of past/missed/unread events on entry) plus un-replied decision_request lister via `okx-a2a user outdated-list`. Not for wallet / gas / task-list / status queries.
Full instructions & audit →onchainos Skills
onchainos skills for AI coding assistants. Provides token search, market data, wallet balance queries, swap execution, transaction broadcasting, leaderboard rankings, token cluster analysis, and direct third-party DApp routing across 20+ blockchains.
Supported Chains
XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon, and 20+ other chains.
Workflows
Pre-built workflow orchestrations in workflows/ compose multiple skills into complete operations. The agent reads workflows/INDEX.md to route requests, then follows the step-by-step instructions in the matched workflow file.
| Workflow | What it does | CLI command |
|---|---|---|
| Token Research | Price, security, holders, cluster, smart money signals, optional launchpad deep-dive | onchainos workflow token-research --address <addr> |
| Daily Brief | Market pulse + smart money + new token activity + portfolio alerts | — |
| Smart Money Signals | SM signal list aggregated by token + per-token due diligence | onchainos workflow smart-money |
| New Token Screening | MIGRATED launchpad scan + safety & dev enrichment for top 10 | onchainos workflow new-tokens |
| Wallet Analysis | 7d/30d PnL, trading behaviour, recent on-chain activity | onchainos workflow wallet-analysis --address <addr> |
| Portfolio Check | Balances, total value, 30d PnL overview | onchainos workflow portfolio --address <addr> |
| Wallet Monitor | In-session polling — alert on new trades from watched wallets | — |
| Wallet Monitor (WS) | Background WebSocket session for offline wallet monitoring | — |
Composite CLI commands
Single commands that replace multiple individual tool calls:
# Token report: info + price + advanced-info + security scan (parallel)
onchainos token report --address <addr> --chain solana
# Full workflow commands
onchainos workflow token-research --address <addr> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <addr> [--chain ethereum]
onchainos workflow portfolio --address <addr> [--chains ethereum,solana]MCP Server
The onchainos CLI doubles as a native MCP server exposing tools to any MCP-compatible client.
Claude Code
claude mcp add --scope user onchainos-cli onchainos mcpAPI Key Security Notice & Disclaimer
Built-in Sandbox API Keys (Default) This integration includes built-in sandbox API keys for testing purposes only. By using these keys, you acknowledge and accept the following:
- These keys are shared and may be subject to rate limiting, quota exhaustion, or unexpected behavior at any time without prior notice.
- Any Agent execution errors, failures, financial losses, or data inaccuracies arising from the use of built-in keys are solely your responsibility.
- We expressly disclaim all liability for any direct, indirect, incidental, or consequential damages resulting from the use of built-in sandbox keys in production or quasi-production environments.
- Built-in keys are strictly intended for local testing and evaluation only. Do not use them in production environments or with real assets.
Production Usage (Recommended) For stable and reliable production usage, you must provide your own API credentials by setting the following environment variables:
OKX_API_KEYOKX_SECRET_KEYOKX_PASSPHRASE
You are solely responsible for the security, confidentiality, and proper management of your own API keys. We shall not be liable for any unauthorized access, asset loss, or damages resulting from improper key management on your part.
Prerequisites
All skills require OKX API credentials. Apply at OKX Developer Portal.
Recommended: create a .env file in your project root:
OKX_API_KEY="your-api-key"
OKX_SECRET_KEY="your-secret-key"
OKX_PASSPHRASE="your-passphrase"Security warning: Never commit .env to git (add it to .gitignore) and never expose credentials in logs, screenshots, or chat messages.
Installation
Recommended
npx skills add okx/onchainos-skillsWorks with Claude Code, Cursor, Codex CLI, and OpenCode. Auto-detects your environment and installs accordingly.
Claude Code
# Run in Claude Code
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skillsCodex CLI
Tell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.codex/INSTALL.mdOpenClaw
Tell OpenClaw:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.openclaw/INSTALL.mdOpenCode
Tell OpenCode:
Fetch and follow instructions from https://raw.githubusercontent.com/okx/onchainos-skills/refs/heads/main/.opencode/INSTALL.mdInstall CLI
Shell Script (macOS / Linux)
Auto-detects your platform, downloads the latest stable release, verifies SHA256 checksum, and installs to ~/.local/bin:
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | shTo install the latest beta version (includes pre-releases):
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh -s -- --betaNote: Beta versions (e.g.,
v2.0.0-beta.0) are opt-in only. The default installer and all skill auto-updates always use the latest stable release. Running without--betawill never downgrade a beta installation whose base version is ahead of the latest stable.
PowerShell (Windows)
Auto-detects your platform, downloads the latest stable release, verifies SHA256 checksum, and installs to %USERPROFILE%\.local\bin:
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iexTo install the latest beta version (includes pre-releases):
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1))) --betaNote: The same beta/stable rules apply — default installs always use the latest stable release, and
--betais opt-in only.
One install gets you everything — 17 skills — kept up to date together.
License
MIT