OKX OnChainOS: on-chain trading, analytics, security, DeFi across 20+ chains. Use when running OKX-routed on-chain ops (e.g. swap on Ethereum, scan token risk, track smart money, check wallet portfolio). Wallet: default to the user's Agent Wallet (via the `wallet` skill). Only use the OnchainOS TEE

OKX OnChainOS — Skills Directory What this file is: a directory page that points to OKX's official onchainos skills repo. It contains no logic of its own — every sub skill below lives upstream at [ okx/onchainos skills ](https://github.com/okx/onchainos skills) and is fetched fresh on install, so you always get the latest version. OKX OnChainOS is a suite of 8 specialized sub skills covering on chain trading, market analytics, smart money signals, DeFi investing & positions, wallet ops, security scanning, payment protocols, agent identity & task marketplace, and crypto news & sentiment across 20+ blockchains (Ethereum, Solana, XLayer, Base, BSC, Arbitrum, Polygon, Optimism, Avalanche, TRON, …). Most sub skills drive a single binary, onchainos , which is downloaded on first use. A subset of capabilities (read only data) can also be accessed without the binary, via Starchild's sc proxy — see Authentication options below. How install actually works Each sub skill ships its own SKILL.md + reference docs + trigger phrases, so you can pull just what you need. Plugin marketplace (alternative): CLI install (the onchainos binary — auto detects platform, verifies SHA256, installs to ~/.local/bin or %USERPROFILE%\.local\bin ): Wallet — default to the user's Agent Wallet Use the platform wallet skill for signing and broadcasting. OKX DEX endpoints return unsigned calldata ( {to, value, data, ...} ); feed it to wallet transfer(data=<calldata ) and you're done. No separate OKX wallet needed. Only use the OnchainOS TEE wallet ( onchainos wallet login <email ) when the user explicitly asks for it. Authentication options (read this before invoking anything) There are two distinct paths. Pick based on what the agent needs to do: Path A — Direct HTTP via Starchild sc proxy (no API Key needed) For read only data lookups (prices, K line, smart money signals, token analytics, security checks, public address portfolios — ≈ 80 % of OnchainOS capabilities ), the agent can skip the CLI entirely and call https://web3.okx.com/... directly through sc proxy: sc proxy auto injects platform OKX credentials, signs each request with HMAC SHA256, and bills the caller's Starchild credits. Cost : $0.001 / request Rate limit : 60 req/min Setup : none Limits : data only — cannot send transactions or manage wallets Path B — onchainos CLI with your own OKX Web3 API Key For wallet ops ( wallet login , wallet send , wallet contract call ), DEX swaps that need execution, payments, and any other CLI driven workflow. The onchainos CLI ships with built in sandbox API keys that work out of the box for local testing — no setup required. These keys are shared, rate limited, and for evaluation only : do NOT use them in production or with real assets. Any failures or losses from using the built in keys are the caller's responsibility. For production, bring your own credentials: 1. Apply at [web3.okx.com → OnchainOS → Dev Portal](https://web3.okx.com/onchain os/dev portal) 2. Set env vars (or a .env in the project root — never commit it): 3. Run any sub skill's CLI commands. Why the CLI can't use sc proxy The onchainos binary uses Rust's rustls TLS stack with bundled webpki roots — a compile time copy of the Mozilla root CA list. It ignores the system trust store, ignores SSL CERT FILE , and has no documented env override. As a result, sc proxy's MITM CA is rejected as UnknownIssuer , and the CLI cannot be transparently proxied. Path A (direct HTTP from agent scripts) is the only way to use platform credentials with OnchainOS today. Wallet creation ( onchainos wallet login <email ) gives you a fresh TEE managed account — it does NOT import your existing OKX App / extension wallet. Sub skills by category 📊 Discovery & Market Data (2) Sub skill Use for okx dex market Read only on chain DEX data: real time prices / K line / index / wallet PnL, address tracker activities, smart money / whale / KOL signal tracking + leaderboard rankings, token search / metadata / market cap / rankings / liquidity / hot tokens / holder & cluster analysis / top traders / trade history, crypto news / sentiment / vibe / KOL leaderboard, meme pump / trenches scanning / dev reputation / bundle detection, and WS/script real time streaming okx dapp discovery Third party DApp discovery and direct plugin routing — currently supports Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer 💼 Wallet, Trading & Security (1) Sub skill Use for 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 🏦 DeFi (1) Sub skill Use for okx defi OKX aggregated DeFi: product discovery, deposit, withdraw, claim rewards across Aave, Lido, PancakeSwap, Kamino, NAVI and more, plus positions and holdings overview across protocols and chains 💸 Payments (1) Sub skill Use for 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. 🤖 Agent & AI (2) Sub skill Use for okx ai ERC 8004 on chain Agent identity (register / update / search / rate / service list) + agent task marketplace (publish / accept / deliver / dispute) + live task progress monitor okx guide Onboarding & guide hub: Onchain OS onboarding + welcome banner, OKX.AI intro & role registration routing, customer support / Help Center guidance 🛠️ Ops (1) Sub skill Use for okx growth competition Agentic Wallet exclusive trading competitions: list, join, view leaderboard, claim rewards Quick task → sub skill map I want to… Sub skill Suggested path Check a token price or chart okx dex market A (no key) Search / analyze a token's holders okx dex market A (no key) Follow smart money buys okx dex market A (no key) Scan new meme launches okx dex market A (no key) Look at any public wallet okx agentic wallet (public address portfolio) A (no key) Scan a token / dApp for risk okx agentic wallet (security scanning) A (no key) Estimate gas / simulate a tx okx agentic wallet (gateway) A or B Manage / send from my own wallet okx agentic wallet B (requires login) Swap tokens okx agentic wallet (DEX swap) REST + sign with the wallet skill (Agent Wallet) Find best DeFi yield (any protocol) okx defi B (signing) View my DeFi positions okx defi A (no key) Use a specific DApp (Aave, Polymarket, …) okx dapp discovery B (full DApp flow) Pay an x402 / MPP / a2a pay gated resource okx agent payments protocol B (signing) Register / rate an on chain agent, agent task marketplace okx ai B (signing) Onboarding, OKX.AI intro, customer support okx guide A (no key) Join a trading competition okx growth competition B (wallet required) Debug a CLI failure okx agentic wallet (audit log) B (local CLI logs) Workflows — pre built multi skill orchestrations Beyond individual sub skills, the repo ships workflow orchestrations under workflows/ that compose several skills into one complete operation. The agent reads workflows/INDEX.md to route a request, 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: Typical skill flows Search & buy : okx dex market (find token) → okx agentic wallet (check funds + execute trade) Portfolio overview : okx agentic wallet (holdings) → okx dex market (enrich with analytics + price charts) Market research : okx dex market (trending/rankings + candles/history) → okx agentic wallet (trade) Swap & broadcast : okx agentic wallet (get quote → swap → broadcast → track order) Full trading flow : okx dex market (search + price/chart) → okx agentic wallet (check balance → swap → simulate + broadcast + track) Leaderboard → research → trade : okx dex market (top traders by PnL/win rate + token analytics) → okx agentic wallet (execute trade) Follow smart money : okx dex market (KOL/smart money buys + token details + holder cluster + price chart) → okx agentic wallet (trade) MCP server The onchainos CLI doubles as a native MCP server, exposing its tools to any MCP compatible client. Start it with: Important notes Chain identifiers : both human names ( ethereum , solana , xlayer ) and numeric IDs are accepted. Run onchainos swap chains or onchainos gateway chains for the full list. Read only ops (market data, signals, security scan, public address portfolios) work via Path A without any user supplied API Key. Trading & sending default to the user's Agent Wallet via the wallet skill. Only fall back to onchainos wallet login when the user asks. Security gate : when okx agentic wallet 's security scanning reports a fail, the calling agent MUST block the related operation rather than proceed. Resources Upstream repo : [okx/onchainos skills](https://github.com/okx/onchainos skills) OnchainOS docs : [OKX Web3 Build — OnchainOS](https://www.okx.com/web3/build/docs/onchain os/introduction) Skills registry : [skills.sh/okx/onchainos skills](https://skills.sh/okx/onchainos skills) Dev portal (API Key) : [web3.okx.com/onchain os/dev portal](https://web3.okx.com/onchain os/dev portal)