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:

• d573a84c-8e79-4a35-b0c6-427e9ad2478d

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
  • 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

ChainIndex Quick Reference

• Ethereum: 1
• BSC: 56
• XLayer: 196
• Solana: 501
• Base: 8453
• Arbitrum: 42161

Always prefer runtime discovery (dex-okx-market-price-chains / dex-okx-dex-aggregator-supported-chains / 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
  • 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.

References

• Invocation patterns:
  • references/usage-patterns.md