Skip to content

Latest commit

 

History

History
131 lines (112 loc) · 8.04 KB

README-CN.md

File metadata and controls

131 lines (112 loc) · 8.04 KB

Crypto Trading Agents

License Python Version Docs Original Paper

感谢

本项目基于Tauric Research团队的TradingAgents，以及arxiv.org/pdf/2412.20138。在此表示诚挚的感谢！

此外，以下作者与仓库也为本仓库提供了思路：

作者 仓库
@delenzhang TradingAgents
@hsliuping TradingAgents-CN

示例报告

BTC-2025-07-01

特色功能

💰 针对加密货币：基于 TradingAgents 的分析思路和基础框架，针对加密货币进行调整
📈 结合专业的技术分析：从技术分析网站中获取重要指标数据，而不是仅依靠大模型单纯的语义分析，减少不可靠的定性胡扯
📰 定向可靠信源：从加密货币交易员常用信源获取新闻数据，确保信息可靠、有针对性，同时还免费！
❤️ 符合你的交易风格：可以自定义投资偏好，无论你是激进交易者还是长期投资者，都可以将你的投资风格偏好和计划告诉分析师，以获得定制化的报告与建议
🚀 引入外部报告：你还可以将你收集的外部报告提供给分析师参考
📄 生成 PDF 或 Markdown 报告
📧 将报告通过邮件发送：可以结合系统定时任务实现定时生成报告，无需手动操作，同时确保报告的及时性。市场报告随时可以送到你的桌面上，就像你是投资主管一样
🎥 报告实时记录：生成的报告实时写入日志文件./logs中。即使程序中途出错，仍然可以看到已生成的报告，你的 API 资源不会白花
⚙️ 可自定义：项目提供了修改或增加信息源的指南，你可以快速自行调整或增加新的信源

使用教程

安装

克隆仓库：

git clone https://github.com/Tomortec/CryptoTradingAgents.git
cd TradingAgents

创建虚拟环境：

conda create -n tradingagents python=3.13
conda activate tradingagents

安装依赖：

pip install -r requirements.txt

配置

1. 配置大模型 API_KEY

在./cli目录下复制.env.example文件，重命名为.env，并填入大模型 API_KEY，例如：千问DASHSCOPE_API_KEY=XXXXXX、ChatGPTOPENAI_API_KEY=XXXXXX

查看支持的大模型列表及API_KEY命名

2. 配置信息源 API_KEY

在./cli/.env文件内填入信息源 API_KEY

查看支持的信息源列表及API_KEY 命名

3. 检查并修改配置

在./tradingagents/default_config.py中修改语言、大模型配置

4.（可选）配置投资偏好

在./cli目录下创建investment_preferences文件，并填入投资偏好

5.（可选）配置邮件发送

修改./tradingagents/default_config.py中的send_report_to_email选项为True；随后复制./mailsender/.env.example，并重命名为.env，修改其中邮箱相关内容

运行程序

目前可以有命令行运行和脚本运行两种方式。命令行运行带有界面，而脚本运行可以很方便地用于定时任务的创建，例如设定每小时生成报告并发送到邮箱等功能。

命令行运行

在终端运行程序：

python -m cli.main
命令行运行步骤
  1. 输入资产代码，例如 BTC、ETH
  2. 输入分析日期
  3. 选择分析团队，目前包括“市场分析师”、“社媒分析师”、“新闻分析师”和“基本面分析师”
  4. 选择研究深度
  5. 导入外部报告，输入y并回车将打开默认编辑器，在其中可输入外部观点供大模型参考。输入完成后需保存
  6. 导入投资偏好，可使用./cli/investment_preferences文件中保存的投资偏好，也可在编辑器中输入（可留空）
  7. 选择模型
  8. 获取分析报告，等待分析完毕后，可在./tradingagents/reports目录下查看报告。报告示例：BTC分析

脚本运行

  1. 根据需要自行修改./cli/run.py中的内容，例如ticker等属性
  2. 在终端运行命令，将自动执行分析：
python -m cli.run

支持的大模型

名称 API命名 是否测试可用
阿里通义千问Qwen DASHSCOPE_API_KEY ✅
ChatGPT OPENAI_API_KEY ✅

支持的信息源列表

来源 名称 API命名 信息类型 API 注册地址
Alternative.me 恐惧贪婪指数 无需 API_KEY 情绪 无
Binance K线数据、交易深度、24 小时价格变动、多空比等 无需 API_KEY 市场 无
Blockbeats Blockbeats 重要资讯 无需 API_KEY 新闻 无
CoinDesk CoinDesk 新闻 COINDESK_API_KEY 新闻 https://developers.coindesk.com/settings/api-keys
CoinStats CoinStats 新闻 COINSTATS_API_KEY 新闻 https://openapi.coinstats.app
Reddit Reddit 帖子 REDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET、REDDIT_USERNAME、REDDIT_PASSWORD、REDDIT_USER_AGENT 情绪与新闻 https://old.reddit.com/prefs/apps
taapi.io EMA、MACD、RSI、Supertrend、布林带、红三兵等 TAAPI_API_KEY 技术分析 https://taapi.io/my-account

自定义

自定义提示词

修改./tradingagents/i18n/prompts下的文件即可

自定义信息源

请阅读./tradingagents/dataflows/README.md

后续可能的更新

  • 开启大模型搜索功能以获取更丰富的信息
  • 自动发送报告
  • 结合 freqtrade 进行模拟交易
  • 提供更多大模型，例如 DeepSeek（使用千问的Embedding模型）
  • 结合最新 LLM 文献优化提示词
  • UI 界面
  • 整合其他价格预测工具（请自行实现，可以参考自定义信息源了解如何向大模型发送数据；一些价格预测工具包括CryptoMamba、Cryptopulse等）

重要声明

本项目仅用于研究和教育目的，不构成投资建议。投资有风险，决策需谨慎。

本人实践经验

购买位于新加坡等海外地区的轻量级服务器（低配的即可），以此能够访问 Binance、Reddit 等数据服务。配置好 CryptoTradingAgents 后可以使用 Linux Crontab 启动定时执行任务。此时，便不需要操作即可在手机上定时收到实时市场报告。


欢迎贡献，包括但不限于提出 Issue、修复错误、实现新功能、完善文档、本地化等！
⭐️⭐️ 如果这个项目对您有帮助，请给我们一个 Star！⭐️⭐️