okx-mcp-skill

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