Metadata

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

For quick read-only trial, OKX docs currently expose a shared demo key:

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.

Confirm endpoint and protocol with help-first probing:
- uxc https://web3.okx.com/api/v1/onchainos-mcp -h
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
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
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
Prefer read operations first, then high-impact operations.

Market:
- dex-okx-market-price
- dex-okx-market-trades
- dex-okx-market-candlesticks
- dex-okx-market-candlesticks-history
- 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
- dex-okx-balance-total-token-balances
- dex-okx-balance-specific-token-balance
Swap:
- dex-okx-dex-aggregator-supported-chains
- dex-okx-dex-liquidity
- dex-okx-dex-quote
- dex-okx-dex-approve-transaction
- dex-okx-dex-swap
- dex-okx-dex-solana-swap-instruction

Always prefer runtime discovery (dex-okx-market-price-chains / dex-okx-dex-aggregator-supported-chains / dex-okx-balance-chains) when possible.

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
- dex-okx-dex-solana-swap-instruction
Solana caveat from OKX docs:
- for market candles/trades, use wSOL token address So11111111111111111111111111111111111111112
- for some price contexts, SOL system address 11111111111111111111111111111111 may also appear in docs
- when data is empty on Solana, verify operation-level address expectation first.