# Okx > 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 wallet (`onchainos wallet login `) when the user explicitly asks for it. - Skill: `starchild-ai-agent/okx` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds add starchild-ai-agent/okx` - Raw SKILL.md: https://api.skillmd.com/api/skills/starchild-ai-agent/okx/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Data & Analytics - Author: starchild-ai-agent (https://skillmd.com/u/starchild-ai-agent) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/starchild-ai-agent/okx --- # 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 ```bash # Install one sub-skill (recommended — pulls just what you need) npx skills add okx/onchainos-skills@ # Or via long form npx skills add https://github.com/okx/onchainos-skills --skill # Install everything (auto-detects your environment and installs accordingly) npx skills add okx/onchainos-skills ``` Each sub-skill ships its own SKILL.md + reference docs + trigger phrases, so you can pull just what you need. **Plugin marketplace** (alternative): ```text /plugin marketplace add okx/onchainos-skills /plugin install onchainos-skills ``` **CLI install** (the `onchainos` binary — auto-detects platform, verifies SHA256, installs to `~/.local/bin` or `%USERPROFILE%\.local\bin`): ```bash # macOS / Linux curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh # add `-s -- --beta` for the latest pre-release (opt-in only; never downgrades) ``` ```powershell # Windows irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex ``` --- ## 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=)` and you're done. No separate OKX wallet needed. Only use the OnchainOS TEE wallet (`onchainos wallet login `) 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: ```python from core.http_client import proxied_get r = proxied_get( "https://web3.okx.com/api/v6/dex/aggregator/supported/chain", headers={"SC-CALLER-ID": f"chat:{thread_id}"}, ) ``` 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): ```bash export OKX_API_KEY= export OKX_SECRET_KEY= export OKX_PASSPHRASE= ``` 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 `) 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 ` | | 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 ` | | Portfolio Check | Balances, total value, 30d PnL overview | `onchainos workflow portfolio --address ` | | 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: ```bash # Token report: info + price + advanced-info + security scan (parallel) onchainos token report --address --chain solana # Full workflow commands onchainos workflow token-research --address [--chain solana] onchainos workflow smart-money [--chain solana] onchainos workflow new-tokens [--chain solana] [--stage MIGRATED] onchainos workflow wallet-analysis --address [--chain ethereum] onchainos workflow portfolio --address [--chains ethereum,solana] ``` ### 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: ```bash onchainos mcp ``` --- ## 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)