EasyTrader 安装与使用教程

EasyTrader 安装与使用教程

easytrader提供同花顺客户端/国金/华泰客户端/雪球的基金、股票自动程序化交易以及自动打新，支持跟踪 joinquant /ricequant 模拟交易 和 实盘雪球组合, 量化交易组件项目地址:https://gitcode.com/gh_mirrors/ea/easytrader

1. 项目目录结构及介绍

在EasyTrader项目中，目录结构大致如下：

EasyTrader/
│
├── README.md        # 项目简介和说明文档
├── requirements.txt # 必要的依赖库列表
├── easytrader/       # 主体代码库
│   ├── __init__.py   # 包初始化文件
│   ├── config.py     # 配置文件模板
│   └── ...           # 其他模块文件
│
└── examples/         # 示例代码目录
    ├── example1.py   # 基本使用示例
    ├── example2.py   # 更复杂功能的示例
    └── ...            # 更多示例

• README.md: 项目的基本信息和使用指南。
• requirements.txt: 列出项目运行所需的Python库，用于安装依赖。
• easytrader: 存放所有核心源代码，包括API接口、数据处理等。
• config.py: 默认配置文件模板，可以根据需求进行修改。
• examples: 包含多个示例代码，帮助快速了解如何使用EasyTrader。

2. 项目启动文件介绍

EasyTrader项目没有特定的启动文件，因为它作为一个库被导入到Python环境中使用。通常，您会在自己的Python脚本中导入easytrader模块并调用相关函数来实现自动化交易功能。例如：

from easytrader import client

# 初始化客户端
trader = client.login('your_username', 'your_password')

# 执行交易操作
trader.buy('stock_code', quantity)

这里的client.py是easytrader中的一个主要入口点，它提供了连接和操作交易客户端的方法。

3. 项目的配置文件介绍

EasyTrader允许您通过配置文件定制其行为。默认配置文件位于easytrader/config.py，其中包含了以下关键设置：

# 账户信息
USERNAME = ''
PASSWORD = ''

# 交易客户端类型
CLIENT_TYPE = 'ht Securities'  # 可选值包括：'ht Securities' (海通证券), 'gtja Online' (国金证券), 'htqh' (同花顺), 'snowball' (雪球)

# 自动登录设置
AUTO_LOGIN = True

# ...

您可以根据实际使用的交易客户端和服务调整这些配置。例如，如果使用海通证券客户端，USERNAME和PASSWORD应分别填写您的账户名和密码。另外，若要禁用自动登录，可以将AUTO_LOGIN设为False。

在您的项目中，可以通过创建自己的配置文件并加载自定义设置，如下所示：

import configparser
from easytrader import load_config

config = configparser.ConfigParser()
config.read('my_config.ini')  # 读取自定义配置文件

# 加载配置
custom_config = load_config(config)

# 创建客户端时传入自定义配置
trader = client.init(custom_config)

这样，您就可以根据自己的需求调整EasyTrader的行为，以便更好地集成到您的自动化交易流程中。

请注意，EasyTrader库可能还需要一些特定的环境或第三方软件支持，如安装了相应券商的交易软件。详细信息请参考项目文档或GitHub页面上的README。

easytrader提供同花顺客户端/国金/华泰客户端/雪球的基金、股票自动程序化交易以及自动打新，支持跟踪 joinquant /ricequant 模拟交易 和 实盘雪球组合, 量化交易组件项目地址:https://gitcode.com/gh_mirrors/ea/easytrader