If you can think it,
your agent can trade it.

Trade on OKX with natural language, from market signals to execution. MCP Server + CLI + Skills, open source, keys never leave your device.

npm install -g okx-trade-mcp okx-trade-cli
$ okx market ticker ETH-USDT
ETH-USDT $3,487.20 ▲ +1.82% 24h Vol: $9.3B
> Show my current positions and P&L
Calling swap_get_positions + account_get_balance
BTC-USDT-SWAP Long 0.1 Entry: $87,432 uPnL: +$128.50 (+0.15%)
Available balance: 8,240.32 USDT
> Long BTC-USDT-SWAP 0.1 at market, TP at 92000, SL at 84000
Calling swap_place_order

Works with every MCP client

Two ways to trade

One powerful engine. Choose how you connect.

MCP server

Talk to OKX using Claude, ChatGPT, or any AI supporting MCP. Just say what you want—the AI builds the strategy and executes the trade.

#AI-Native#Claude/GPT#Market Data
عرض المستندات

CLI

Trade directly from your terminal. Pipe market data into scripts, schedule cron jobs, and automate anything in your dev stack.

#Terminal#Shell Pipes#Cron Jobs
عرض المستندات

Plug-and-Play Skills

Pick the capabilities you need. Each skill is a self-contained module. Install one, or install them all.

npx skills add okx/agent-skills
okx-cex-market

Marktdaten

Echtzeit-Ticker, Orderbuch-Tiefe, Candlesticks, Finanzierungsraten, Open Interest und Indexdaten. Kein API-Schlüssel erforderlich.

#Public#Real-time#No Auth
okx-cex-trade

Handel

Spot, Futures, Optionen und erweiterte Order. Order ausführen, stornieren, ändern oder zusammenfassen, einschließlich OCO, Trailing-Stops und Grid-Bots.

#Spot#Futures#Options#Algo
okx-cex-portfolio

Portfolio

Verfolge Guthaben, Positionen, GuV, Abrechnungsverlauf, Gebührensätze und Transfers. Erhalte umfassende Einblicke ins Portfolio mit einem einzigen Skill.

#Balance#Positions#P&L#Fees
Browse all skills on GitHub

Built for any and every trading setup

Every strategy type from grid bots, algo orders, DCA, to arbitrage, built with a sentence.

Portfolio health check

“Show my P&L for the past week and total fees paid”

Get a full breakdown of your PnL, fees, and exposure. Know exactly where your portfolio stands, instantly.

News-driven trading

“The SEC just approved a new crypto ETF. Buy 1,000 USDT of BTC at market.”

React to market events instantly. Just say what you want to do, and the AI executes your trade in seconds. No screen-switching required.

Spot trading with TP/SL

“Buy 500 USDT of ETH at market. Set take-profit at 3,800 and stop-loss at 3,500.”

Open a spot position with built-in take-profit and stop-loss. No need to manage separate algo orders—just one intent, one action.

DCA on dips

“I have 1,000 USDT — buy BTC every time it drops 2%”

Set your budget and dip threshold. The AI staggers your buy orders, letting you accumulate crypto without watching the market.

Grid trading bot

“Set up an ETH-USDT grid between $3,200 and $3,800 with 10 grids”

Capture range-bound volatility automatically. The AI calculates spacing, sizes your investment, and places every order.

Batch order management

“Cancel all my open orders for BTC/USDT.”

Clear your open orders in a single sentence. The AI fetches your pending orders and batch-cancels them instantly. No more manually clicking through lists.

Get Started in 3 Minutes

01 Install
npm install -g okx-trade-mcp okx-trade-cli
02 Initialize
mkdir -p ~/.okx && vim ~/.okx/config.toml

# ~/.okx/config.toml
default_profile = "demo"

[profiles.demo]
site = "global"
api_key = "your-demo-api-key"
secret_key = "your-demo-secret-key"
passphrase = "your-demo-passphrase"
demo = true
03 Trade
okx-trade-mcp setup --client claude-desktop  # or: cursor / vscode / claude-code

# MCP — natural language in Claude Desktop / Cursor
"Show my account balance"
"Long BTC 0.1 SWAP at market with SL at 85000"
# CLI — terminal + script integration
okx market ticker BTC-USDT
okx market candles ETH-USDT --bar 1H --limit 200 --json
No API Key needed for market data — use --modules market for zero-config access. Create API Keys at OKX (live and demo keys are managed separately).

FAQ

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.

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.

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

Safety is a shared responsibility — here’s what you do, and what OKX does for you.

• What you should do:
1. Create a dedicated sub-account for AI with its own API Key — never mix with your main account
2. Only fund the AI account with what you’re willing to allocate — keep it separate from your main balance
3. Never paste your API Key directly into an AI conversation
4. Set trading permissions to require approval — every trade needs your confirmation
5. Start with demo mode to test your setup before going live
6. Never share sensitive personal information with the Agent
7. Do not install or enable unofficial Skills — this could lead to asset loss

• What OKX does for you:
1. Keys are stored locally only — the AI can never access them
2. Read-only mode: AI can view data but cannot execute any actions
3. Module-level permission control: precisely decide which capabilities AI can use
4. Live and demo trading are fully isolated — testing never touches real funds
5. Rate limiting: abnormal commands are automatically blocked
6. Fully open source — audit every line of code yourself

Absolutely. Everything runs locally, but please keep your key secure and avoid exposing it to AI clients. 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.

Yes, but it depends entirely on your OKX account permissions.
Agent Trade Kit can only execute what your account is already authorized to do. If your account is approved to trade futures, perpetual swaps, or options on OKX, the toolkit can trade them too.
However, if your account type or region restricts certain products (like derivatives), those tools won’t work. Agent TradeKit cannot bypass OKX’s compliance or account restrictions.
Think of it like a remote control: it only works for the channels you’re already subscribed to. If you’re unsure what your account can access, check your OKX account settings.

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 AgentTrade 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.