weex-trading

📈 WEEX 永续合约智能交易助手

基于 WEEX 官方 API 的自动化交易工具,支持最高 125 倍杠杆的 USDT 本位永续合约交易,提供完整的账户管理、订单执行和风险控制功能。

收藏
15.1k
安装
3.8k
版本
latest
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

核心用法

weex-trading 是一个专为 WEEX 交易所设计的开放式 AI Agent 技能,允许用户通过自然语言或程序化方式操作 USDT 本位永续合约。该技能通过 REST API 与 WEEX 服务器通信,支持 38 个核心端点,涵盖市场数据查询(行情、K线、资金费率)、账户管理(余额、杠杆、保证金)、订单操作(市价/限价单、条件单、止盈止损)以及 AI 交易日志记录。用户需配置 WEEX_API_KEYWEEX_API_SECRETWEEX_PASSPHRASE 环境变量,即可在 Claude、GPT、Gemini 等任何支持 bash/curl 的 AI Agent 中直接调用交易指令。

显著优点

全平台兼容性是最大亮点,该技能不绑定特定 AI 平台,采用标准 shell 命令实现,理论上支持所有 LLM-based Agent。功能完整性出色,覆盖从基础行情查看到高级条件单、125 倍杠杆调节、全仓/逐仓切换等专业交易需求。文档质量极高,不仅提供详尽的 API 端点说明,还包含订单类型对照表、错误码解决方案和费率限制说明。安全设计规范,所有敏感操作均依赖环境变量,代码中无硬编码凭证,且明确包含 "Safety Rules" 要求执行前必须用户确认。

潜在缺点与局限性

作为 T3 级个人开发者项目,长期维护稳定性和社区支持能力存疑,不适合对合规性要求极高的机构用户。代码层面 缺少严格的输入验证,Python 脚本通过索引访问命令行参数,缺乏类型检查和边界验证,存在潜在的参数错误风险。此外,该技能 无内置的二次确认机制,虽然文档警告需用户确认,但实际执行时仍可能因 AI 误操作导致非预期交易。最后,依赖系统标准工具(curl/jq/openssl)意味着在 Windows 环境或精简容器中可能需要额外配置。

适合的目标群体

主要面向 加密货币量化交易爱好者AI Agent 重度用户,特别是希望用自然语言管理交易头寸的个人投资者。适合已熟悉期货合约机制、具备风险承受能力的 中级交易者,以及需要快速搭建交易原型的开发者。对于希望实现半自动化交易策略(如设置条件单、自动记录交易日志)的用户尤为适用。不推荐加密货币新手、风险厌恶型投资者或需要完全自动化高频交易的专业机构使用。

使用风险

资金安全风险是首要考量,125 倍杠杆在放大收益的同时极可能导致爆仓,且加密货币市场波动剧烈。API 密钥泄露风险需警惕,尽管代码无硬编码,但环境变量配置不当或日志泄露可能导致密钥被盗,建议严格设置 IP 白名单并定期轮换密钥。执行风险包括网络延迟导致的滑点、API 速率限制(10 req/sec)影响高频操作,以及 AI 理解错误指令导致的误交易。合规风险方面,WEEX 在某些司法管辖区可能受限,用户需自行确保符合当地法规。

安全解读

核心用法

weex-trading 是一个面向AI Agent的WEEX期货交易所API封装工具,通过bash/curl命令实现完整的合约交易功能。核心能力包括:

  • 市场数据获取:实时行情、深度数据、K线、资金费率、持仓量等无认证接口
  • 账户管理:资产查询、杠杆调整(1-125倍)、保证金模式切换(全仓/逐仓)、自动追加保证金
  • 订单系统:市价/限价单、高级订单(Post-only/FOK/IOC)、批量撤单、一键平仓
  • 条件单与风控:触发订单(止盈止损)、TP/SL订单独立管理
  • AI集成:支持上传AI交易决策日志到交易所

使用流程:配置WEEX_API_KEY/WEEX_API_SECRET/WEEX_PASSPHRASE环境变量 → 调用对应bash脚本 → 解析JSON响应。

显著优点

1. 通用兼容:声称支持Claude、GPT、Gemini、LLaMA、Mistral等任何支持shell命令的AI Agent
2. 功能完整:覆盖WEEX合约API几乎全部能力,包括125倍高杠杆、复杂条件单

3. 安全实现:HMAC-SHA256签名认证,无硬编码密钥,纯环境变量管理凭证

4. 透明开源:MIT协议,代码可审计,依赖仅requests等标准库

潜在缺点与局限性

1. 极端金融风险:125倍杠杆意味着1%价格波动即可爆仓,无内置风险控制机制
2. T3来源可信度:个人开发者维护(bowen31337),非知名机构,代码质量依赖社区审查

3. 操作门槛高:需理解合约交易专业术语(全仓/逐仓、资金费率、标记价格等)

4. 无实时流数据:仅提供REST API封装,无WebSocket实时行情(文档提及但未完整实现)

5. 依赖网络稳定性:所有操作需实时连接WEEX服务器,无离线能力

适合人群

  • 专业加密货币交易者:熟悉合约机制、能自主管理风险的用户
  • 量化策略开发者:需要程序化执行WEEX交易策略的开发者
  • AI Agent实验者:探索LLM自主交易能力的科研人员(仅限模拟盘/极小资金

常规风险

| 风险类型 | 说明 |
|---------|------|
| 资金风险 | 杠杆交易可能导致本金全部损失,甚至穿仓负债 |
| 密钥泄露 | 环境变量管理不善可能导致API密钥被盗,资金被转移 |
| 技术故障 | 网络延迟、API异常可能导致订单未执行或重复执行 |
| 合规风险 | 部分地区禁止高杠杆合约交易,需自行确认合法性 |
| 代码风险 | T3来源存在潜在未审计漏洞,虽静态分析通过但无法完全排除 |

weex-trading 内容

references文件夹
scripts文件夹
手动下载zip · 12.4 kB
api_reference.mdtext/markdown
请选择文件