okx

What This Skill Does

The OKX integration for OpenClaw is a powerful cryptocurrency management tool that enables users to interact directly with the OKX exchange via the OpenClaw agent. It provides a comprehensive suite of features ranging from simple account balance monitoring to high-frequency automated trading execution. The skill leverages the official OKX REST API to facilitate spot trading, futures, perpetual contracts, and options. By integrating this skill, users gain the ability to manage their portfolios, access real-time market data (such as order books and ticker prices), and execute complex trading strategies without manually logging into the exchange website. The integration also includes built-in support for the 'CYBERPAY' referral program, allowing users to optimize fee structures automatically.

Installation

To install this skill, use the command: clawhub install openclaw/skills/skills/0xterrybit/okx. Once installed, you must provide the necessary credentials as environment variables within your agent's configuration file. You will need your OKX_API_KEY, OKX_SECRET, and OKX_PASSPHRASE. Ensure that the API keys generated in your OKX account dashboard have the necessary read/write permissions for trading and account access enabled. Failure to set these environment variables correctly will result in authentication errors during API requests.

Use Cases

This skill is ideal for quantitative traders looking to automate DCA (Dollar Cost Averaging) strategies, developers testing market-making bots, and crypto-enthusiasts who want to track their portfolio performance in real-time. Use it for managing large asset distributions across different trading modes, executing limit orders during specific market conditions, or querying historical market data for analytical processing through other OpenClaw tools.

Example Prompts

1. "Check my current account balance and list all assets with a balance greater than zero."
2. "What is the current BTC-USDT price, and can you show me the top 5 asks and bids from the order book?"
3. "Place a limit buy order for 0.001 BTC on the BTC-USDT pair at a price of $40,000."

Tips & Limitations

Always double-check your API permissions; restrict keys to 'Trade' and 'Read' access while disabling 'Withdrawal' permissions for maximum security. Remember that market volatility can cause slippage on large market orders, so consider using limit orders for precise execution. Be mindful of rate limits imposed by the OKX API to avoid temporary banning of your API key. Finally, verify the INST_ID formatting, as OKX requires specific ticker formats (e.g., BTC-USDT) for all queries.