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:
2. uxc https://web3.okx.com/api/v1/onchainos-mcp -h
3. Configure credential/binding for repeatable auth:
4. uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-env OKX_ACCESS_KEY
5. uxc auth credential set okx-mcp --auth-type api_key --api-key-header OK-ACCESS-KEY --secret-op op://Engineering/okx/OK-ACCESS-KEY
6. uxc auth binding add --id okx-mcp --host web3.okx.com --path-prefix /api/v1/onchainos-mcp --scheme https --credential okx-mcp --priority 100
7. Use fixed link command by default:
8. command -v okx-mcp-cli
9. If missing, create it: uxc link okx-mcp-cli https://web3.okx.com/api/v1/onchainos-mcp
10. okx-mcp-cli -h
11. Inspect operation schema before execution:
12. okx-mcp-cli dex-okx-market-price -h
13. okx-mcp-cli dex-okx-market-token-search -h
14. okx-mcp-cli dex-okx-balance-total-value -h
15. okx-mcp-cli dex-okx-dex-quote -h
16. 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