okx-agent-tradekit

What This Skill Does

OKX Agent Trade Kit is the official open-source toolkit designed to bridge the gap between AI agents and the OKX exchange. By installing this skill, users can interact with OKX markets, manage portfolios, execute spot, futures, options, and grid bot trades using natural language. It is designed to work seamlessly within the OpenClaw ecosystem, providing an abstraction layer that allows your AI agent to fetch real-time market data (order books, candles, funding rates) and perform financial operations directly via your terminal or chat interface.

Installation

For OpenClaw users, installation is streamlined into a single command. Simply type the following in your OpenClaw chat: npx skills add okx/agent-skills. This command pulls the necessary four modules: okx-cex-market, okx-cex-trade, okx-cex-portfolio, and okx-cex-bot. After the skill is initialized, you must configure your API credentials. Create a configuration file at ~/.okx/config.toml by providing your API key, secret, and passphrase. It is highly recommended to use a dedicated sub-account API key for security purposes rather than your main account. If you are using an MCP client like Claude Desktop or Cursor, refer to the project's documentation for local environment setup via the MCP server pattern.

Use Cases

This toolkit serves three primary user personas. First, traders who want to perform manual analysis via AI, such as asking for real-time BTC price updates or checking the funding rates of perpetual swaps. Second, algorithmic traders who want to deploy automated grid bots without writing complex custom scripts; you can simply describe your strategy parameters, and the agent executes the bot creation. Third, power users who manage multiple sub-accounts and need a quick, natural-language interface to check balances, current open orders, or historical account performance without navigating the complex OKX web interface.

Example Prompts

1. "What is the current market price for ETH-USDT and show me the latest funding rate for the perpetual swap?"
2. "Place a market buy order for 500 USDT of BTC using my demo account configuration."
3. "Set up a grid trading bot for SOL-USDT with a price range between 150 and 250, using 10 grids and 500 USDT."

Tips & Limitations

Security is paramount: never share your API keys in chat sessions. Always utilize the 'demo' mode for initial testing of trading commands before moving to production live keys. Note that AI agents are non-deterministic; treat all execution commands as assistive and maintain human oversight for major financial decisions. Ensure your Node.js environment is version 18 or higher. If you are in restricted regions, remember to set the site parameter in your config.toml to 'eea' or 'us' accordingly.