A comprehensive DeFi automation skill for accessing OKX OnchainOS market data, wallet balances, and DEX swap execution via uxc.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install okx-mcp-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install okx-mcp-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OKX OnchainOS MCP Skill?
The OKX OnchainOS MCP skill is a powerful extension designed to bridge AI agents with the extensive on-chain data and trading capabilities of OKX. By utilizing this skill within the Openclaw Skills ecosystem, developers can enable their agents to perform complex DeFi tasks across multiple ecosystems including Ethereum, Solana, and Base. It provides a structured interface for querying real-time market prices, analyzing token rankings, and managing wallet balances through a standardized protocol.
Built on top of the uxc utility, this skill ensures that technical workflows remain consistent and secure. It emphasizes a help-first approach where agents can inspect command schemas before execution, reducing errors in transaction planning. Whether you are building a trading bot, a portfolio tracker, or a research assistant, this skill provides the necessary primitives to interact with blockchain data at scale.
OKX OnchainOS MCP Skill Use Cases
- Real-time token discovery and market ranking analysis across various blockchains.
- Automated monitoring of wallet balances and total portfolio valuation.
- Fetching historical candlestick data for technical analysis and price prediction models.
- Generating and validating quotes for DEX swaps and managing token approval transactions.
How OKX OnchainOS MCP Skill Works
- The agent probes the OKX OnchainOS MCP endpoint to discover available operations and protocol specifications.
- Authentication is configured using secure API key headers, which can be linked to environment variables or secret managers.
- A local CLI alias, okx-mcp-cli, is established to provide a simplified interface for the agent's execution environment.
- The agent performs schema inspection for specific tasks to ensure all required parameters, such as ChainIndex or token addresses, are correctly formatted.
- Operations are executed with a focus on read-only data first, followed by high-impact transaction planning with built-in safety guardrails.
OKX OnchainOS MCP Skill Setup
Follow these steps to initialize the skill within your environment:
# Configure your OKX API credentials
uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY
# Bind the credential to the OKX OnchainOS endpoint
uxc auth binding add --id okx-mcp --host web3.okx.com --path-prefix /api/v1/onchainos-mcp --scheme https --credential okx-mcp --priority 100
# Create a local command link for easier access
uxc link okx-mcp-cli https://web3.okx.com/api/v1/onchainos-mcp
OKX OnchainOS MCP Skill Data Schema & Taxonomy
The skill organizes operations into four primary domains to streamline data retrieval within Openclaw Skills:
| Domain | Key Operations | Metadata / Purpose |
|---|---|---|
| Market | dex-okx-market-price, dex-okx-market-candlesticks | Provides current and historical price action. |
| Discovery | dex-okx-market-token-search, dex-okx-market-token-ranking | Identifies trending tokens and holder distributions. |
| Wallet | dex-okx-balance-total-value, dex-okx-balance-chains | Aggregates balances across multiple supported networks. |
| Swap | dex-okx-dex-quote, dex-okx-dex-swap | Manages liquidity quotes and transaction payloads. |
OKX OnchainOS MCP Skill Advanced Features
- Multi-chain support covering Ethereum (1), BSC (56), XLayer (196), Solana (501), Base (8453), and Arbitrum (42161).
- Automated JSON output parsing to ensure high-fidelity data extraction for agentic workflows.
- Explicit guardrails for high-impact operations like dex-swap and dex-approve-transaction.
- Seamless integration with uxc for shared protocol discovery and credential management.
- Dynamic runtime discovery of supported chains and aggregator liquidity.
SKILL.md
Loading
Related Openclaw Skills
Notion MCP Skill
A secure interface for AI agents to interact with Notion workspaces using the Model Context Protocol and UXC CLI.
Linear GraphQL Skill
A robust interface for AI agents to interact with Linear's GraphQL API for issue management and team collaboration.
Etherscan MCP Skill
A high-performance interface for onchain investigation, providing deep access to Ethereum blockchain data via the Etherscan MCP.
Dune MCP Skill
A powerful tool for AI agents to discover, query, and visualize blockchain data directly from Dune Analytics.
Playwright MCP Skill
Automate web browsers through the Model Context Protocol using Playwright and uxc for reliable agentic web interaction.
The Graph MCP Skill
Enables AI agents to perform subgraph discovery, schema retrieval, and GraphQL execution using The Graph's MCP endpoint.
Featured*
