← 返回目录
D

Dex Trade Agent Kit

社区
将 OKX 交易接入 AI 助手的本地 MCP 服务器
GitHub 源仓库 ↗
★ 127 Stars 分类 · 其他 热门 源版本 16944d11f930
30FMRS · D
可靠性
4/20
安全与权限
5/20
维护活跃度
5/20
文档质量
9/20
安装易用性
7/20

该 MCP 服务器提供全面的交易功能,涵盖多个模块,本地运行保障隐私。适合技术用户,但需要谨慎操作真实资金。

查看 FMRS 评分方法 →

DEX Agent Trade Kit 是一个基于 AI 的交易工具包,包含两个独立包:dex-trade-mcp(用于 Claude、Cursor 等任何兼容 MCP 的客户端)和 dex-trade-cli(用于终端操作)。它通过模型上下文协议 (MCP) 将 AI 助手直接连接到您的 OKX 账户。它在本地进程中运行,API 密钥仅存储在您的机器上,无云端服务。提供 145 个工具,涵盖 11 个模块:市场数据、现货、永续合约、交割合约、期权、账户管理、事件合约、理财、交易机器人、新闻和聪明钱信号。包括内置算法订单(条件单、OCO 止盈止损、追踪止损)、安全控制(--read-only 标志、模块过滤、限速器)、零基础设施(本地 stdio 进程)以及预构建的代理技能文件。

工具能力

market_get_ticker
获取市场行情
market_get_orderbook
获取订单簿
market_get_candles
获取K线数据
market_get_index_ticker
获取指数行情
market_get_index_candles
获取指数K线
market_get_price_limit
获取价格限制
market_get_funding_rate
获取资金费率
market_get_mark_price
获取标记价格
market_get_open_interest
获取未平仓合约量
market_get_stock_tokens
获取股票代币
market_get_indicators
获取技术指标
market_get_indicator_list
获取指标列表
market_filter_market
按条件筛选市场
market_get_oi_history
获取未平仓合约历史
market_get_oi_change_filter
按未平仓合约变化筛选
spot_place_order
现货下单
spot_cancel_order
撤消现货订单
spot_amend_order
修改现货订单
spot_batch_orders
批量现货订单
spot_get_fills
获取现货成交记录
spot_get_order_history
获取现货历史订单
spot_place_conditional_order
下条件单
spot_cancel_conditional_order
取消条件单
spot_place_oco_order
下 OCO 订单
spot_cancel_oco_order
取消 OCO 订单
swap_place_order
永续合约下单
swap_cancel_order
撤消永续合约订单
swap_amend_order
修改永续合约订单
swap_batch_orders
批量永续合约订单
swap_get_positions
获取永续合约持仓
swap_set_leverage
设置杠杆
swap_place_conditional_order
下永续条件单
swap_cancel_conditional_order
取消永续条件单
swap_place_oco_order
下永续 OCO 订单
swap_cancel_oco_order
取消永续 OCO 订单
swap_place_trailing_stop
下追踪止损订单
swap_cancel_trailing_stop
取消追踪止损订单
futures_place_order
交割合约下单
futures_cancel_order
撤消交割合约订单
futures_amend_order
修改交割合约订单
futures_close_position
平仓交割合约
futures_set_leverage
设置交割合约杠杆
futures_batch_orders
批量交割合约订单
futures_place_algo_order
下算法订单
futures_cancel_algo_order
取消算法订单
futures_get_positions
获取交割合约持仓
futures_get_fills
获取交割合约成交
futures_get_order_history
获取交割合约历史订单
option_place_order
期权下单
option_cancel_order
撤消期权订单
option_amend_order
修改期权订单
option_batch_cancel
批量取消期权订单
option_get_order_history
获取期权历史订单
option_get_positions
获取期权持仓
option_get_fills
获取期权成交
option_get_chain
获取期权链
option_get_iv_greeks
获取期权隐含波动率和 Greeks
account_get_balance
获取账户余额
account_get_bills
获取账单
account_get_positions
获取账户持仓
account_get_positions_history
获取历史持仓
account_get_fee_rates
获取费率
account_get_config
获取账户配置
account_set_position_mode
设置持仓模式
account_get_max_withdrawal
获取最大提款额
account_get_max_avail_size
获取最大可用数量
account_get_audit_log
获取审计日志
event_browse_contracts
浏览事件合约
event_get_series
获取事件系列
event_get_events
获取事件
event_get_markets
获取市场
event_place_order
事件合约下单
event_amend_order
修改事件合约订单
event_cancel_order
取消事件合约订单
event_get_orders
获取事件合约订单
event_get_fills
获取事件合约成交
earn_get_balance
获取理财余额
earn_purchase
购买理财产品
earn_redeem
赎回理财产品
earn_get_lending_rate
获取借贷利率
earn_place_fixed_term_order
下定期理财订单
earn_get_fixed_term_orders
获取定期理财订单
earn_get_onchain_staking
获取链上质押信息
earn_stake
进行链上质押
earn_unstake
解除链上质押
earn_get_dcd_products
获取双币赢产品
earn_place_dcd_order
下双币赢订单
earn_get_flash_earn
获取闪兑理财
bot_create_grid
创建网格交易机器人
bot_amend_grid
修改网格机器人
bot_close_grid
关闭网格机器人
bot_get_grid_orders
获取网格订单
bot_create_dca
创建 DCA 机器人
bot_amend_dca
修改 DCA 机器人
bot_close_dca
关闭 DCA 机器人
bot_get_dca_orders
获取 DCA 订单
news_get_latest
获取最新新闻
news_filter_by_coin
按币种筛选新闻
news_search
搜索新闻
news_get_article
获取文章详情

安装接入

  1. 确保 Node.js >= 18。2. 全局安装:npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli。3. 配置 OKX API 凭证:运行 okx config init 并按照交互式向导操作。4. 注册 MCP 服务器:使用 okx-trade-mcp setup --client claude-desktop 或其他客户端参数(如 cursor、claude-code、vscode)。或者,使用一键安装脚本,它自动处理 Node.js 检查、安装和客户端检测。
claude_desktop_config.json
{
  "mcpServers": {
    "okx-trade-mcp": {
      "command": "okx-trade-mcp",
      "args": [
        "--modules",
        "all"
      ]
    }
  }
}

选型与风险

适合谁

  • 使用 Claude、Cursor 等 AI 助手进行交易的用户
  • 需要自动化和算法订单的交易者
  • 希望本地运行、不依赖云服务的用户
  • 需要无需认证的市场数据和技术指标的分析师

不适合谁

  • 不想在本地终端运行或不喜欢命令行的用户
  • 非 OKX 用户(仅支持 OKX 交易所)
  • 需要移动端或 Web 界面而非本地进程的用户
  • 对访问密钥安全有严格要求的用户(尽管密钥本地存储)

所需权限

  • 需要 OKX API 密钥(读和写权限)才能进行交易操作
  • 对于市场数据模块,不需要身份验证
  • 根据使用的模块可能要求启用特定的 API 权限,如交易、提现、理财等
  • 工具在本地进程运行,无需外部网络服务(但可能向 OKX API 发出请求)

风险与副作用

  • 真实资金交易风险:AI 可能错误执行订单
  • API 密钥存储在本地,需确保机器安全
  • 工具可能实时更改账户状态(如杠杆、持仓模式)
  • 依赖 OKX API 稳定性,可能面临限速或服务中断
  • 错误配置可能导致订单参数无效或意外交易

常见排障

  1. 确保 Node.js 版本 >= 18
  2. 运行 `okx config init` 重新配置凭证
  3. 检查 API 密钥权限是否足够
  4. 查看错误输出中的结构化错误块(包含工具名称、错误代码、端点、traceId),并据此诊断
  5. 如果在 VS Code 中,确认生成了 .mcp.json 文件
  6. 查看 FAQ 文档 docs/faq.md 了解常见问题

使用场景

通过 AI 助手自然语言执行现货、合约和期权交易
实时获取市场数据、技术指标和价格筛选
管理账户余额、持仓和费率设置
创建和管理网格或 DCA 交易机器人
参与理财、链上质押和双币赢产品
跟踪加密货币新闻和聪明钱信号

支持客户端

Claude Desktop完整支持
Cursor完整支持
Claude Code完整支持
VS Code完整支持