agent-trade-kit  by okx

AI agent framework for automated crypto trading on OKX

Created 2 months ago
287 stars

Top 91.2% on SourcePulse

GitHubView on GitHub
Project Summary

Summary OKX Agent Trade Kit securely connects AI agents to the OKX exchange via the Model Context Protocol (MCP). It enables AI clients to directly execute trades across spot, futures, options, and other products locally, eliminating the need to switch between AI and exchange interfaces. This toolkit empowers AI-driven trading strategies with comprehensive features while ensuring API keys remain on the user's machine.

How It Works The okx-trade-mcp server acts as a local MCP endpoint, translating AI commands into OKX API calls. This architecture requires zero infrastructure, running as a local stdio process. Security is paramount, with API keys kept exclusively on the user's device. Granular control is provided through safety features and a wide array of trading tools.

Quick Start & Requirements

  • Prerequisites: Node.js >= 18.
  • Installation: npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli. A one-line install script is available.
  • Configuration: Initialize API credentials: okx config init. Register MCP server: okx-trade-mcp setup --client <client_name>.
  • Running: okx-trade-mcp (default), okx-trade-mcp --modules market (read-only), okx-trade-mcp --profile live --modules all.

Highlighted Details

  • 14 tools across 11 modules: market data, spot, swap, futures, options, account, earn, bots (Grid, DCA), news, smart money signals.
  • Built-in algo orders: Conditional, OCO, trailing stops.
  • Safety controls: --read-only flag, per-module filtering, rate limiter.
  • MCP compatibility: Claude Desktop, Cursor, openCxxW, VS Code.
  • Pre-built Agent Skills for AI frameworks.

Maintenance & Community No specific contributors, sponsorships, or community channels (Discord/Slack) are detailed. Issue reporting is via GitHub, with structured error reporting for MCP and CLI interactions.

Licensing & Compatibility Released under the permissive MIT license, generally allowing commercial use and integration. API keys are handled locally, enhancing security.

Limitations & Caveats Requires Node.js >= 18. The README does not explicitly list known bugs or unsupported platforms. Users are directed to report errors via GitHub issues, indicating potential for issues requiring user reporting.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
4
Star History
124 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Travis Fischer Travis Fischer(Founder of Agentic), and
2 more.

agentkit by coinbase

0.4%
1k
SDK for AI agents to interact with crypto wallets and onchain
Created 1 year ago
Updated 4 days ago
Feedback? Help us improve.