Skill: jolestar/okx-mcp-skill (version 1.0.1)

--- name: okx-mcp-skill description: Use OKX OnchainOS MCP through UXC for token discovery, market data, wallet balance, and swap execution planning. Use when tasks need OKX MCP tools such as token search/ranking/holder, price/trades/candlesticks/index, balance queries, and DEX quote/swap flows with help-first schema inspection and safe auth handling. --- # OKX MCP Skill Use this skill to run OKX MCP operations through `uxc`. Reuse the `uxc` skill for shared protocol discovery, output parsing, and generic auth/binding flows. ## Prerequisites - `uxc` is installed and available in `PATH`. - Network access to `https://web3.okx.com/api/v1/onchainos-mcp`. - OKX Onchain API key is available for real calls. ## Quick Trial Key For quick read-only trial, OKX docs currently expose a shared demo key: - [REDACTED_SECRET] Example: - `uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret d573a84c-8e79-4a35-b0c6-427e9ad2478d` Use your own key for regular usage, stability, and production workflows. ## Core Workflow 1. Confirm endpoint and protocol with help-first probing: - `uxc https://web3.okx.com/api/v1/onchainos-mcp -h` 2. Configure credential/binding for repeatable auth: - `uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY` - `uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-op op://Engineering/okx/OK-ACCESS-KEY` - `uxc auth binding add --id okx-mcp --host web3.okx.com --path-prefix /api/v1/onchainos-mcp --scheme https --credential okx-mcp --priority 100` 3. Use fixed link command by default: - `command -v okx-mcp-cli` - If missing, create it: `uxc link okx-mcp-cli https://web3.okx.com/api/v1/onchainos-mcp` - `okx-mcp-cli -h` 4. Inspect operation schema before execution: - `okx-mcp-cli dex-okx-market-price -h` - `okx-mcp-cli dex-okx-market-token-search -h` - `okx-mcp-cli dex-okx-balance-total-value -h` - `okx-mcp-cli dex-okx-dex-quote -h` 5. Prefer read operations first, then high-impact operations. ## Capability Map - Market: - `dex-okx-market-price` - `dex-okx-market-trades` - `dex-okx-market-candlesticks` - [REDACTED_SECRET] - `dex-okx-index-current-price` - `dex-okx-index-historical-price` - Token discovery/enrichment: - `dex-okx-market-token-search` - `dex-okx-market-token-ranking` - `dex-okx-market-token-holder` - `dex-okx-market-token-basic-info` - `dex-okx-market-token-price-info` - Wallet: - `dex-okx-balance-chains` - `dex-okx-balance-total-value` - [REDACTED_SECRET] - [REDACTED_SECRET] - Swap: - [REDACTED_SECRET] - `dex-okx-dex-liquidity` - `dex-okx-dex-quote` - `dex-okx-dex-approve-transaction` - `dex-okx-dex-swap` - [REDACTED_SECRET] ## ChainIndex Quick Reference - Ethereum: `1` - BSC: `56` - XLayer: `196` - Solana: `501` - Base: `8453` - Arbitrum: `42161` Always prefer runtime discovery (`dex-okx-market-price-chains` / [REDACTED_SECRET] / `dex-okx-balance-chains`) when possible. ## Guardrails - Keep automation on JSON output envelope; do not rely on `--text`. - Parse stable fields first: `ok`, `kind`, `protocol`, `data`, `error`. - Use `okx-mcp-cli` as default command path. - `okx-mcp-cli <operation> ...` is equivalent to `uxc https://web3.okx.com/api/v1/onchainos-mcp <operation> ...`. - If call result contains `Request header OK-ACCESS-KEY can not be empty`: - confirm auth binding matches endpoint with `uxc auth binding match https://web3.okx.com/api/v1/onchainos-mcp` - update credential with explicit header: `uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY` - confirm credential has a secret source (`--secret-env`, `--secret-op`, or literal `--secret`) - For high-impact operations require explicit user confirmation: - `dex-okx-dex-approve-transaction` - `dex-okx-dex-swap` - [REDACTED_SECRET] - Solana caveat from OKX docs: - for market candles/trades, use wSOL token address [REDACTED_SECRET] - for some price contexts, SOL system address [REDACTED_SECRET] may also appear in docs - when data is empty on Solana, verify operation-level address expectation first. ## References - Invocation patterns: - `references/usage-patterns.md`


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)