OKX Agent Trade Kit

v1.0.0Finance & Fintechstable

okx trading bot okx agent mcp cli cryptocurrency okx api automated trading typescript okx trading bot model context protocol cursor ai trading crypto spot futures okx trading bot npm pnpm okx mcp open source quant defi cex okx trading bot algorithmic

ai-tradingalgorithmic-tradingautomated-tradingcexcli
Share:
337
Stars
0
Downloads
0
Weekly
0/5

What is OKX Agent Trade Kit?

OKX Agent Trade Kit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to okx trading bot okx agent mcp cli cryptocurrency okx api automated trading typescript okx trading bot model context protocol cursor ai trading crypto spot futures okx trading bot npm pnpm okx mcp open...

okx trading bot okx agent mcp cli cryptocurrency okx api automated trading typescript okx trading bot model context protocol cursor ai trading crypto spot futures okx trading bot npm pnpm okx mcp open source quant defi cex okx trading bot algorithmic

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • okx trading bot okx agent mcp cli cryptocurrency okx api aut

Use Cases

Trade crypto on OKX via AI agents.
Automate spot and futures trading.
Execute algorithmic strategies.
dex-original

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx okx-agent-trade-kit

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OKX Agent Trade Kit

OKX Agent Trade Kit is a comprehensive MCP server and CLI toolkit that gives AI agents programmatic access to the OKX cryptocurrency exchange through 145 tools spanning 11 trading modules. It supports spot trading, perpetual futures, options, delivery contracts, algorithmic bot strategies (grid and DCA), account management, market data with 70+ technical indicators, and crypto news with sentiment analysis. Credentials are stored locally after a one-time interactive setup, and the server can be run in read-only mode for safe market data access without risking funds.

Prerequisites

  • Node.js 18 or higher installed
  • An OKX account with API access enabled
  • OKX API credentials: API key, secret key, and passphrase (generated in OKX account settings)
  • npm installed for global package installation
  • An MCP-compatible client such as Claude Desktop or Cursor (for MCP mode)
1

Install the OKX Agent Trade Kit packages

Install both the MCP server and CLI packages globally using npm. Node.js 18 or higher is required.

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

Initialize your OKX API credentials

Run the interactive credential wizard to store your OKX API key, secret key, and passphrase locally. This is required before the MCP server or CLI can access your OKX account.

okx config init
3

Test market data access (no authentication required)

Verify the installation by fetching market data. Market data tools work without API credentials and are a safe way to confirm everything is working.

okx market ticker BTC-USDT
4

Configure your MCP client to use the server

Add the OKX Trade MCP server to your MCP client configuration. You can restrict it to specific trading modules or enable read-only mode for safety.

{
  "mcpServers": {
    "okx-agent-trade-kit": {
      "command": "okx-trade-mcp",
      "args": ["--read-only"]
    }
  }
}
5

Enable specific trading modules as needed

For live trading, restart the server without --read-only and optionally restrict to specific modules. The server exposes 145 tools across 11 modules by default.

# MCP server with only market and spot modules:
okx-trade-mcp --modules market,spot

# Full access for all 145 tools:
okx-trade-mcp

OKX Agent Trade Kit Examples

Client configuration (Claude Desktop)

Full claude_desktop_config.json entry for OKX Agent Trade Kit in read-only market data mode.

{
  "mcpServers": {
    "okx-agent-trade-kit": {
      "command": "okx-trade-mcp",
      "args": ["--read-only"]
    }
  }
}

Prompts to try

Example prompts that work well once the OKX Agent Trade Kit is connected to your AI assistant.

- "What is the current BTC-USDT price and 24h volume on OKX?"
- "Show me the order book for ETH-USDT and analyze the bid/ask spread"
- "Check my account balance across all currencies"
- "Place a market buy order for 100 USDT worth of BTC on the spot market"
- "Show me the top performing traders on OKX leaderboard today"
- "Get the latest crypto news and sentiment score for Ethereum"

Troubleshooting OKX Agent Trade Kit

API credential errors when placing orders

Re-run 'okx config init' to update your stored credentials. Ensure your OKX API key has the correct permissions enabled (trade, read) in your OKX account API management settings, and that your IP is whitelisted if IP restriction is enabled.

Trading commands fail with 'insufficient permissions' even with correct API key

Check that you are not running the MCP server with the --read-only flag. Also verify that your OKX API key has trade permissions enabled — view-only keys cannot place orders.

MCP server command not found after npm global install

After 'npm install -g', the global npm bin directory must be on your system PATH. Run 'npm bin -g' to find the directory and add it to your PATH in your shell profile (.zshrc, .bashrc, etc.), then restart your terminal.

Frequently Asked Questions about OKX Agent Trade Kit

What is OKX Agent Trade Kit?

OKX Agent Trade Kit is a Model Context Protocol (MCP) server that okx trading bot okx agent mcp cli cryptocurrency okx api automated trading typescript okx trading bot model context protocol cursor ai trading crypto spot futures okx trading bot npm pnpm okx mcp open source quant defi cex okx trading bot algorithmic It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OKX Agent Trade Kit?

Follow the installation instructions on the OKX Agent Trade Kit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OKX Agent Trade Kit?

OKX Agent Trade Kit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OKX Agent Trade Kit free to use?

Yes, OKX Agent Trade Kit is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "okx-agent-trade-kit": { "command": "npx", "args": ["-y", "okx-agent-trade-kit"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OKX Agent Trade Kit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides