Introduction

OKX Agent Trade Kit connects AI assistants directly to your OKX account. Instead of switching between your AI and the exchange, you describe what you want — the AI executes it.

It runs as a local process on your machine. Your API keys never leave your device. Fully open source under the MIT license.

The official OKX toolkit for AI-powered trading. Let your AI agent trade spot, futures, options, and more on OKX — using natural language.

GitHub · npm: okx-trade-mcp · npm: okx-trade-cli

This page may not reflect the latest release. For the most up-to-date tool list, module details, configuration options, and changelog, always refer to the GitHub repository: github.com/okx/agent-trade-kit

What can it do?

1. Market data — prices, order books, candles, funding rates, open interest
2. Spot trading — place, cancel, amend orders, batch operations, algo orders
3. Futures & swaps — perpetual and delivery contracts, leverage, positions
4. Options — order placement, option chains, Greeks (IV, Delta, Gamma, Theta, Vega)
5. Algo orders — conditional orders, OCO take-profit/stop-loss, trailing stops
6. Account — balances, bills, fee rates, position management
7. Bots — create, monitor, and stop grid strategies

Three ways to use it

• MCP Server (okx-trade-mcp) — Plug into Claude, Cursor, Codex, OpenCode, or any AI client that supports MCP. Your agent calls OKX tools via natural language.
• CLI (okx-trade-cli) — Trade from the terminal. Works with shell pipes, cron jobs, and scripts — no AI client needed.
• Skills (okx-cex-market, okx-cex-trade, okx-cex-portfolio, okx-cex-bot) — Plug-and-play modules for AI clients that support the Skills protocol (e.g. OpenClaw). Install one, some, or all.

On this page: OpenClaw · MCP Clients · MCP Server · CLI · Skills · Safety · FAQ

Quick Start

OpenClaw

Security notice: Never paste your API Key, Secret Key, or Passphrase into the chat. OpenClaw's AI cannot and should not access your credentials directly — keep them in your config file only. Because AI behavior in OpenClaw is non-deterministic, we strongly recommend using a sub-account API key rather than your main account, and enabling only the permissions you need.

Step 1 — Install Skills

Open OpenClaw and paste this into the chat — not the command line:

Run npx skills add okx/agent-skills, resolve any issues you encounter, then check the BTC price.

Step 2 — Configure your API credentials

Open Terminal and run:

mkdir -p ~/.okx && cat > ~/.okx/config.toml << 'EOF'
default_profile = "demo"

[profiles.live]
api_key    = "your-live-api-key"
secret_key = "your-live-secret-key"
passphrase = "your-live-passphrase"

[profiles.demo]
api_key    = "your-demo-api-key"
secret_key = "your-demo-secret-key"
passphrase = "your-demo-passphrase"
demo       = true
EOF

Open ~/.okx/config.toml in any text editor, fill in your api_key, secret_key, and passphrase, then save.

Where to get keys: API page — start with a demo key.

MCP Clients

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf — and any MCP-compatible client.

Step 1 — Install

npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli

Verify:

okx market ticker BTC-USDT

💡 Market data works immediately — no API Key needed.

Step 2 — Add your OKX API credentials

okx config init

The interactive wizard creates ~/.okx/config.toml. Run it once and you are done.

Where to get keys: API page — start with a demo key.

Or configure manually — skip the wizard and create ~/.okx/config.toml directly:

default_profile = "demo"    # which profile to load by default

# Profile names are labels you choose — call them anything.
# Pass --profile <name> at startup to switch between them.
# "demo" and "live" are just conventions; the name itself has no special meaning.

[profiles.demo]
api_key    = "your-demo-api-key"
secret_key = "your-demo-secret-key"
passphrase = "your-demo-passphrase"
demo       = true    # demo = true → simulated trading, zero real funds at risk

[profiles.live]
api_key    = "your-live-api-key"
secret_key = "your-live-secret-key"
passphrase = "your-live-passphrase"
             # no demo flag → live trading with real funds

Site Configuration

OKX operates independent regional sites. Add site to your profile to match where your account is registered:

[profiles.live]
site       = "global"    # global | eea | us  (omit for default: global)
api_key    = "your-api-key"
secret_key = "your-secret-key"
passphrase = "your-passphrase"

Step 3 — Connect your AI client

okx-trade-mcp setup --client <client>

For manual configuration, see Client Setup (Manual) on GitHub.

Step 4 — Try it

Open your AI client and type:

What's the current BTC price on OKX?
Show my account balance
Buy 100 USDT of BTC at market on demo
What's the BTC-USDT-SWAP funding rate?

MCP

The MCP Server exposes OKX trading tools via the Model Context Protocol standard. Register it once, then your AI agent can trade, query, and manage your account.

Startup options

For any MCP client not listed, register it as a stdio server with:

okx-trade-mcp --profile <demo|live> --modules <all|market|spot|swap|...>

Tools

The market module requires no API key. All other modules require Read permission; write operations additionally require Trade permission.

market — Market Data

spot — Spot Trading

swap — Perpetual Contracts

futures — Delivery Contracts

option — Options

account — Account Management

bot — Trading Bots

Grid (bot.grid)

DCA (bot.dca)

CLI

The CLI is a standalone terminal tool — no AI client required.

# Market data
okx market ticker BTC-USDT
okx market candles BTC-USDT --bar 1H --limit 10
okx market funding-rate BTC-USDT-SWAP

# Trading
okx spot place --instId BTC-USDT --side buy --ordType market --sz 100
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 --posSide long --tdMode cross

# Account
okx account balance
okx account positions

# Grid bots
okx --demo bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --quoteSz 100

# Pipes & scripting
okx account balance --json | jq '.[] | {ccy: .ccy, eq: .eq}'
okx market candles BTC-USDT --bar 1H --limit 200 --json | python3 analyze.py

Full CLI reference →

Skills

Skills are plug-and-play modules for AI clients that support the Skills protocol. Pick the capabilities you need — install one, some, or all.

npx skills add okx/agent-skills

Browse all skills on GitHub →

Safety

OKX Agent Trade Kit has four layers of protection:

1. Demo mode (--demo) — Trades on simulated account, live funds untouched. Start here.
2. Read-only mode (--read-only) — Only data queries, no trading.
3. Smart registration — The server checks your API Key permissions on startup. If your key can't trade, order tools are never shown to the AI.
4. Risk labels — Every tool that moves money is marked [CAUTION], prompting the AI to confirm before acting.

Built-in rate limiting prevents overloading the OKX API.

Credential safety: Never share your API Key, Secret Key, or Passphrase with any AI model or paste them into a chat. All credentials should stay in your local config file (~/.okx/config.toml) only. Because AI behavior is non-deterministic, we strongly recommend using a sub-account API key with only the permissions you need — avoid granting withdrawal permission unless strictly necessary.

FAQ

Q: What can I do with Agent Trade Kit?

Just about everything you can do on OKX. Check prices, trade spot, futures, and options, set up advanced orders (like stop-loss or trailing stop), manage your account, and run grid bots. You can do it all using natural language or your command line. Check GitHub for the full feature list.

Q: Can I trade futures, options, or other products with Agent Trade Kit?

That depends on your OKX account, not on Agent Trade Kit. The toolkit can only do what your account is already authorized to do on OKX — it has no ability to grant or change your trading permissions.

If your account can trade futures, swaps, or options on OKX, Agent Trade Kit can execute those too. But if your region or account type restricts certain products (for example, users in certain jurisdictions cannot access derivatives), those tools simply won't work for you — Agent Trade Kit cannot bypass these restrictions.

Think of it like a remote control: it can only operate what the TV already supports. If you are unsure what your account can access, check your OKX account settings or contact OKX support.

Q: Will I lose money if the AI makes a mistake?

We built four layers of safety to prevent that. Start in --demo mode to trade with simulated funds, or use --read-only mode to restrict the AI to data queries. Even in live mode, the AI is strictly warned before taking any action with real funds. Read our Safety guide for details. You need to independently verify all relevant information prior to execution. AI can make mistakes, and you are responsible for losses.

Q: Which AI clients are supported?

It works with any AI client that supports the Model Context Protocol (MCP). This includes Claude Desktop, Claude Code, Cursor, VS Code, and custom agents built with the MCP SDK. Right now, it runs locally on your machine, with cloud-hosted support coming soon. We may add or remove certain AI clients at our discretion.

Q: Is it free?

Yes. Agent Trade Kit is 100% free and open-source under the MIT license. All you need is an OKX account and API keys to execute trades. (You don't even need API keys just to pull market data.)

Q: Are my API keys safe?

Absolutely. Everything runs locally. Your keys are securely stored on your device (~/.okx/config.toml), all transactions are signed locally, and the AI never sees your credentials. No data is ever sent anywhere except directly to OKX. Since it's open-source, you can audit the code yourself on GitHub. You are responsible for keeping your API keys safe.

Q: What are the risks of Agent Trade Kit?

The Agent Trade Kit is a collection of servers and toolkits intended to facilitate automated or AI-assisted trading, and does not constitute financial, investment, legal, or tax advice. AI-generated actions may trigger real trades and result in significant losses due to model errors, hallucinations, inaccurate or outdated information, latency, market volatility, slippage, liquidity constraints, technical failures, incorrect parameters, or service disruptions. The Service is provided "as is" and "as available," with no warranties regarding accuracy, completeness, execution reliability, or continuous availability. The Kit may rely on third-party large language models (LLMs) that are not owned, operated, controlled, verified, or endorsed by OKX; OKX disclaims all responsibility and liability for any third-party LLM services or outputs, and you use them entirely at your own risk. You are solely responsible for independently verifying all information, configuring and supervising automated strategies, safeguarding API credentials, applying least-privilege permissions (including avoiding withdrawal permissions unless strictly necessary), binding trusted IPs, and testing with small amounts before scaling. To the maximum extent permitted by law, OKX disclaims liability for any direct or indirect losses arising from use of the Agent Trade Kit, and you agree to indemnify and hold OKX harmless from any claims related to your use, trading activities, or reliance on AI-generated outputs.

Q: How do I report a bug or suggest a feature?

Open an issue on GitHub. If a tool call fails, include the full error block — it contains everything needed to diagnose the problem.

Links

• GitHub (MCP + CLI): github.com/okx/agent-trade-kit
• GitHub (Skills): github.com/okx/agent-skills
• npm: okx-trade-mcp · okx-trade-cli
• OKX Open API: okx.com/docs-v5
• Issues: github.com/okx/agent-trade-kit/issues
• License: MIT

Community

Join the OKX AgentKit Telegram community for the latest updates, tips, and discussions:

t.me/OKX_AgentKit