| 1 | # OKX Agent Trade Kit |
| 2 | |
| 3 | [](https://github.com/okx/agent-tradekit/actions/workflows/ci.yml) |
| 4 | [](https://codecov.io/gh/okx/agent-tradekit) |
| 5 | [](https://www.npmjs.com/package/okx-trade-mcp) |
| 6 | [](https://www.npmjs.com/package/okx-trade-mcp) |
| 7 | [](https://www.npmjs.com/package/okx-trade-cli) |
| 8 | [](https://www.npmjs.com/package/okx-trade-cli) |
| 9 | [](LICENSE) |
| 10 | |
| 11 | [English](README.md) | [中文](README.zh-CN.md) |
| 12 | |
| 13 | OKX Agent Trade Kit — an AI-powered trading toolkit with two standalone packages: |
| 14 | |
| 15 | | Package | Description | |
| 16 | |---|---| |
| 17 | | `okx-trade-mcp` | MCP server for Claude / Cursor and any MCP-compatible AI client | |
| 18 | | `okx-trade-cli` | CLI for operating OKX from terminal | |
| 19 | |
| 20 | --- |
| 21 | |
| 22 | ## What is this? |
| 23 | |
| 24 | OKX Agent Trade Kit connects AI assistants directly to your OKX account via the [Model Context Protocol](https://modelcontextprotocol.io). Instead of switching between your AI and the exchange UI, you describe what you want — the AI calls the right tools and executes it. |
| 25 | |
| 26 | It runs as a **local process** with your API keys stored only on your machine. No cloud services, no data leaving your device. |
| 27 | |
| 28 | ## Features |
| 29 | |
| 30 | | Feature | Description | |
| 31 | |---------|-------------| |
| 32 | | **145 tools across 11 modules** | Full trading lifecycle: market data → orders → algo orders → account management → earn → trading bots → event contracts → news → smart money signals | |
| 33 | | **Algo orders built-in** | Conditional, OCO take-profit/stop-loss, trailing stop | |
| 34 | | **Safety controls** | `--read-only` flag, per-module filtering, built-in rate limiter | |
| 35 | | **Zero infrastructure** | Local stdio process, no server or database required | |
| 36 | | **MCP standard** | Works with Claude Desktop, Cursor, openCxxW, and any MCP-compatible client | |
| 37 | | **Agent Skills included** | Pre-built skill files for AI agent frameworks — drop-in instructions covering market data, trading, portfolio, bots, and earn | |
| 38 | | **Open source** | MIT license, API keys never leave your machine | |
| 39 | |
| 40 | ## Modules |
| 41 | |
| 42 | | Module | Tools | Description | Docs | |
| 43 | |--------|-------|-------------|------| |
| 44 | | `market` | 19 | Ticker, orderbook, candles (+history), index ticker, index candles, price limit, funding rate, mark price, open interest, stock tokens, **technical indicators** (70+ indicators: MA/EMA/RSI/MACD/BB/ATR/KDJ/BTCRAINBOW/AHR999 and more — no auth required), **indicator list**, **market filter** (screen by price/change/marketCap/volume/fundingRate/OI), **OI history**, **OI change filter** | [→](docs/modules/market.md) | |
| 45 | | `spot` | 13 | Place/cancel/amend orders, batch orders, fills (+archive), order history (+archive), conditional orders, OCO | [→](docs/modules/spot.md) | |
| 46 | | `swap` | 17 | Perpetual trading, batch orders, positions, leverage, conditional orders, OCO, trailing stop | [→](docs/modules/swap.md) | |
| 47 | | `futures` | 18 | Delivery contract trading, positions, fills, order history, amend/close/leverage, batch orders, algo orders (TP/SL, OCO, trailing stop) | [→](docs/modules/futures.md) | |
| 48 | | `option` | 10 | Options trading: place/cancel/amend/batch-cancel, order history, positions (with Greeks), fills, option chain, IV + Greeks | [→](docs/modules/option.md) | |
| 49 | | `account` | 14 | Balance, bills (+archive), positions, positions history, fee rates, config, position mode, max withdrawal, max avail size, audit log | [→](docs/modules/account.md) | |
| 50 | | `event` | 9 | Event contract trading: browse, series, events, markets (query); place, amend, cancel, orders, fills (private). Semantic outcome values: UP/YES/ |