103 lines
5.2 KiB
Markdown
103 lines
5.2 KiB
Markdown
# Crypto Trading Agents
|
||
|
||
[](https://opensource.org/licenses/Apache-2.0)
|
||
[](https://www.python.org/)
|
||
[](./VERSION)
|
||
[](./README.md)
|
||
[](https://github.com/TauricResearch/TradingAgents)
|
||
[](https://arxiv.org/pdf/2412.20138)
|
||
|
||
## 感谢
|
||
本项目基于[Tauric Research](https://github.com/TauricResearch)团队的[TradingAgents](https://github.com/TauricResearch/TradingAgents)，以及[arxiv.org/pdf/2412.20138](https://arxiv.org/pdf/2412.20138)。在此表示诚挚的感谢！
|
||
|
||
此外，以下作者与仓库也为本仓库提供了思路：
|
||
|作者|仓库|
|
||
|---|---|
|
||
|[@delenzhang](https://github.com/delenzhang)|[TradingAgents](https://github.com/delenzhang/TradingAgents)|
|
||
|[@hsliuping](https://github.com/hsliuping)|[TradingAgents-CN](https://github.com/hsliuping/TradingAgents-CN)|
|
||
|
||
## 示例报告
|
||
[BTC-2025-07-01](./EXAMPLE_REPORT.md)
|
||
|
||
## 使用教程
|
||
### 安装
|
||
克隆仓库：
|
||
```sh
|
||
git clone https://github.com/Tomortec/CryptoTradingAgents.git
|
||
cd TradingAgents
|
||
```
|
||
创建虚拟环境：
|
||
```sh
|
||
conda create -n tradingagents python=3.13
|
||
conda activate tradingagents
|
||
```
|
||
安装依赖：
|
||
```sh
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 配置
|
||
#### 配置大模型 API_KEY
|
||
在`./cli`目录下创建`.env`文件，并填入大模型 API_KEY，例如：千问`DASHSCOPE_API_KEY=XXXXXX`、ChatGPT`OPENAI_API_KEY=XXXXXX`
|
||
> 查看[支持的大模型列表及API_KEY命名](#支持的大模型)
|
||
#### 配置信息源 API_KEY
|
||
在`./cli/.env`文件内填入信息源 API_KEY
|
||
> 查看[支持的信息源列表及API_KEY 命名](#支持的信息源列表)
|
||
#### 检查并修改配置
|
||
在[`./tradingagents/default_config.py`](./tradingagents/default_config.py)中修改语言、大模型配置
|
||
#### （可选）配置投资偏好
|
||
在`./cli`目录下创建`investment_preferences`文件，并填入投资偏好
|
||
#### 运行程序
|
||
在终端运行程序：
|
||
```sh
|
||
python -m cli.main
|
||
```
|
||
|
||
### 运行步骤
|
||
1. **输入资产代码**，例如 BTC、ETH
|
||
2. **输入分析日期**，同源项目
|
||
3. **选择分析团队**，同源项目
|
||
4. **选择研究深度**，同源项目
|
||
5. **导入外部报告**，输入y并回车将打开默认编辑器，在其中可输入外部观点供大模型参考。输入完成后需保存
|
||
6. **导入投资偏好**，可使用`./cli/investment_preferences`文件中保存的投资偏好，也可在编辑器中输入（可留空）
|
||
7. **选择大模型**，同源项目
|
||
8. **获取分析报告**，等待分析完毕后，可在[`./tradingagents/reports`](./tradingagents/reports)目录下查看报告。报告示例：[BTC分析](./EXAMPLE_REPORT.md)
|
||
|
||
### 支持的大模型
|
||
|名称|API命名|是否测试可用|
|
||
|---|---|---|
|
||
|阿里通义千问Qwen|DASHSCOPE_API_KEY|✅|
|
||
|ChatGPT|OPENAI_API_KEY|✅|
|
||
|
||
### 支持的信息源列表
|
||
|来源|名称|API命名|信息类型|API 注册地址|
|
||
|---|---|---|---|---|
|
||
|[Alternative.me](https://alternative.me/crypto/fear-and-greed-index/)|恐惧贪婪指数|无需 API_KEY|情绪|无|
|
||
|[Binance](https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/market-data/rest-api/Kline-Candlestick-Data)|K线数据、交易深度、24 小时价格变动、多空比等|无需 API_KEY|市场|无|
|
||
|[Blockbeats](https://github.com/BlockBeatsOfficial/RESTful-API)|Blockbeats 重要资讯|无需 API_KEY|新闻|无|
|
||
|[CoinDesk](https://developers.coindesk.com/documentation/data-api/news_v1_article_list)|CoinDesk 新闻|COINDESK_API_KEY|新闻|[https://developers.coindesk.com/settings/api-keys](https://developers.coindesk.com/settings/api-keys)|
|
||
|[CoinStats](https://docs.api.coinstats.app/reference/get-news)|CoinStats 新闻|COINSTATS_API_KEY|新闻|[https://openapi.coinstats.app](https://openapi.coinstats.app/)
|
||
|[Reddit](https://praw.readthedocs.io/en/stable/)|Reddit 帖子|REDDIT_CLIENT_ID、REDDIT_CLIENT_SECRET、REDDIT_USERNAME、REDDIT_PASSWORD、REDDIT_USER_AGENT|情绪与新闻|[https://old.reddit.com/prefs/apps](https://old.reddit.com/prefs/apps/)|
|
||
|[taapi.io](https://taapi.io/indicators/)|EMA、MACD、RSI、Supertrend、布林带、红三兵等|TAAPI_API_KEY|技术分析|[https://taapi.io/my-account](https://taapi.io/my-account/)|
|
||
|
||
### 自定义
|
||
#### 自定义提示词
|
||
修改[`./tradingagents/i18n/prompts`](./tradingagents/i18n/prompts)下的文件即可
|
||
#### 自定义信息源
|
||
请阅读[`./tradingagents/dataflows/README.md`](./tradingagents/dataflows/README.md)
|
||
|
||
## 后续可能的更新
|
||
- [ ] 开启大模型搜索功能以获取更丰富的信息
|
||
- [ ] 自动发送报告
|
||
- [ ] 结合最新 LLM 文献优化提示词
|
||
- [ ] 整合其他价格预测工具
|
||
- [ ] UI 界面
|
||
|
||
## 重要声明
|
||
本项目仅用于研究和教育目的，不构成投资建议。投资有风险，决策需谨慎。
|
||
|
||
<br/>
|
||
|
||
欢迎贡献，包括但不限于**提出 Issue、修复错误、实现新功能、完善文档、本地化**等！
|
||
⭐️⭐️ 如果这个项目对您有帮助，请给我们一个 Star！⭐️⭐️
|