okx / onchainos-skills
★ 307A skill package that teaches your agent 16 capabilities — every one documented and browsable below, no GitHub required · by okx.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Routing 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`.
5 files — installable on its own
ERC-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...
9 files — installable on its own
Use 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...
10 files — installable on its own
MUST 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 budget...
17 files — installable on its own
AUTHORITATIVE source for OKX Agentic Wallet and its Gas Station feature. Gas Station = OKX's stablecoin-gas feature on Solana via third-party Relayer; Solana only, no EIP-7702. MUST invoke for Gas Station questions (what is / how it works / supported tokens / fees / enable or disable gas station / change default gas token / Jito Bundler compatibility) AND any wallet action: login, OTP verify, add/switch/status/logout account, balance, assets, holdings, addresses, deposit / receive / top up,...
28 files — installable on its own
Plugin 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...
3 files — installable on its own
OKX-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...
3 files — installable on its own
Use 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...
1 file — installable on its own
HARD 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. ' 涨跌市场', '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...
9 files — installable on its own
Use 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...
8 files — installable on its own
Surfaces social-layer signals for crypto markets. Three capability groups: news (latest aggregated crypto news feed, filter articles by coin symbol, run full-text keyword searches, fetch a single article in full, and list available upstream platforms — blockbeats, odaily, theblock and similar — for use as filters); sentiment (rank coins by social mention volume over 1h / 4h / 24h, plus per-coin bullish/bearish/neutral counts with an optional time-bucketed trend); vibe (per-contract hotness...
7 files — installable on its own
Use 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...
8 files — installable on its own
Read-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...
8 files — installable on its own
Use 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...
1 file — installable on its own
List 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...
7 files — installable on its own
监听任务进展 / 帮我盯着任务 / 任务有动静告诉我 / 历史消息 / 未读消息 / 未决策 / 待决策 / 继续监听 / 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.
5 files — installable on its own
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.
Available Skills
| Skill | Description |
|---|---|
okx-agentic-wallet | Wallet lifecycle (auth, balance, portfolio PnL, send, tx history, contract call), Gas Station, DEX swap, cross-chain bridge, limit-order strategy, transaction gateway (gas / simulate / broadcast / track order), public-address portfolio, security scanning (token risk, DApp phishing, tx & signature checks, approvals), audit log |
okx-dex-market | Real-time prices, K-line charts, index prices, wallet PnL analysis, address tracker activities |
okx-dex-signal | Smart money / whale / KOL signal tracking, leaderboard rankings |
okx-dex-trenches | Meme pump/trenches token scanning, dev reputation, bundle detection, aped wallets |
okx-dex-token | Token search, metadata, market cap, rankings, liquidity pools, hot tokens, advanced info, holder analysis, top traders, trade history, holder cluster analysis |
okx-dex-social | Crypto news (latest, by symbol, search, detail, source platforms), market-wide sentiment ranking + per-coin sentiment with trend, per-token vibe timeline + TOP50 KOL leaderboard |
okx-agent-payments-protocol | Unified payment dispatcher across x402 (exact / aggr_deferred schemes — TEE or local-key sign), MPP (charge / session intents — open / voucher / topUp / close, transaction or hash mode), and a2a-pay (paymentId-based create / pay / status). Routes to per-scheme/intent references. |
okx-defi-invest | DeFi product discovery, deposit, withdraw, claim rewards across Aave, Lido, PancakeSwap, Kamino, NAVI and more |
okx-defi-portfolio | DeFi positions and holdings overview across protocols and chains |
okx-agent-chat | Agent-to-agent communication: XMTP plugin management, encrypted file attachment upload/download |
okx-dapp-discovery | Third-party DApp discovery and direct plugin routing — currently supports Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer |
okx-growth-competition | Agentic Wallet exclusive trading competitions: list, join, view leaderboard, claim rewards |
Supported Chains
XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon, and 20+ other chains.
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.mdSkill Workflows
The skills work together in typical DeFi flows:
Search and Buy: okx-dex-token (find token) -> okx-agentic-wallet (check funds + execute trade)
Portfolio Overview: okx-agentic-wallet (holdings) -> okx-dex-token (enrich with analytics) -> okx-dex-market (price charts)
Market Research: okx-dex-token (trending/rankings) -> okx-dex-market (candles/history) -> okx-agentic-wallet (trade)
Swap and Broadcast: okx-agentic-wallet (get quote -> swap -> broadcast -> track order)
Full Trading Flow: okx-dex-token (search) -> okx-dex-market (price/chart) -> okx-agentic-wallet (check balance -> swap -> simulate + broadcast + track)
Leaderboard → Research → Trade: okx-dex-signal (top traders by PnL/win rate) -> okx-dex-token (token analytics) -> okx-agentic-wallet (execute trade)
Follow Smart Money: okx-dex-signal (KOL/smart money buys) -> okx-dex-token (token details + holder cluster) -> okx-dex-market (price chart) -> okx-agentic-wallet (trade)
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]Install 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.
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.
License
MIT
Install the whole package (16 skills):
npx skills add https://github.com/okx/onchainos-skillsOr install a single skill:
npx skills add https://github.com/okx/onchainos-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.