easytrader

• 进行自动的程序化股票交易
• 实现自动登录
• 支持跟踪 joinquant 的模拟交易
• 支持跟踪 雪球组合 调仓
• 支持命令行调用，方便其他语言适配
• 支持 Python3 / Python2, Linux / Win, 推荐使用 Python3
• 有兴趣的可以加群 556050652 、549879767(已满) 、429011814(已满) 一起讨论
• 捐助: 支付宝 微信 或者 银河开户可以加群找我

开发环境 : Ubuntu 16.04 / Python 3.5

相关

量化交流论坛

获取新浪免费实时行情的类库: easyquotation

简单的股票量化交易框架 使用 easytrader 和 easyquotation

支持券商

• 银河
• 广发
• 佣金宝

模拟交易

• 雪球组合 by @haogefeifei（说明）

requirements

pip install -r requirements.txt

银河可以直接自动登录

佣金宝 的自动登录需要安装以下二者之一， 广发的自动登录需要安装下列的 tesseract：

• JAVA : 推荐, 识别率高，安装简单, 需要命令行下 java -version 可用 (感谢空中园的贡献)
• tesseract : 非 pytesseract, 需要单独安装, 地址,保证在命令行下 tesseract 可用

安装

pip install easytrader

注： Windows 用户 pip 安装时会提示 No module named xxx, 请使用 pip install xxx 安装对应缺失的 module, 然后再重新 pip install easytrader, 可以参考此文档 INSTALL4Windows.md

升级

pip install easytrader --upgrade

用法

引入:

import easytrader

设置账户:

银河

user = easytrader.use('yh') # 银河支持 ['yh', 'YH', '银河']

佣金宝

user = easytrader.use('yjb') # 佣金宝支持 ['yjb', 'YJB', '佣金宝']

广发

user = easytrader.use('gf') # 广发支持 ['gf', 'GF', '广发']

登录帐号

使用配置文件

user.prepare('/path/to/your/ht.json') // 或者 yjb.json 或者 yh.json 等配置文件路径

参数登录

user.prepare(user='用户名', password='券商加密后的密码, 雪球为明文密码')

注:

使用配置文件模式, 配置文件需要自己用编辑器编辑生成, 请勿使用记事本, 推荐使用 notepad++ 或者 sublime text

格式可以参照 Github 目录下对应的 json 文件

• 佣金宝需要配置 yjb.json 并填入相关信息, 其中的 password 为加密后的 password
• 银河类似佣金宝
• 雪球配置中 username 为邮箱, account 为手机, 填两者之一即可，另一项改为 "", 密码直接填写登录的明文密码即可，不需要抓取 POST 的密码

如何获取配置所需信息, 可参考此文章

交易相关

以下用法以佣金宝为例

获取资金状况:

user.balance

return

[{ 'asset_balance': '资产总值',
   'current_balance': '当前余额',
   'enable_balance': '可用金额',
   'market_value': '证券市值',
   'money_type': '币种',
   'pre_interest': '预计利息' ]}

获取持仓:

user.position

return

[{'cost_price': '摊薄成本价',
   'current_amount': '当前数量',
   'enable_amount': '可卖数量',
   'income_balance': '摊薄浮动盈亏',
   'keep_cost_price': '保本价',
   'last_price': '最新价',
   'market_value': '证券市值',
   'position_str': '定位串',
   'stock_code': '证券代码',
   'stock_name': '证券名称'}]

获取今日委托单

user.entrust

return

[{'business_amount': '成交数量',
  'business_price': '成交价格',
  'entrust_amount': '委托数量',
  'entrust_bs': '买卖方向',
  'entrust_no': '委托编号',
  'entrust_price': '委托价格',
  'entrust_status': '委托状态',  # 废单 / 已报
  'report_time': '申报时间',
  'stock_code': '证券代码',
  'stock_name': '证券名称'}]

买入:

user.buy('162411', price=0.55, amount=100)

return

[{'entrust_no': '委托编号',
  'init_date': '发生日期',
  'batch_no': '委托批号',
  'report_no': '申报号',
  'seat_no': '席位编号',
  'entrust_time': '委托时间',
  'entrust_price': '委托价格',
  'entrust_amount': '委托数量',
  'stock_code': '证券代码',
  'entrust_bs': '买卖方向',
  'entrust_type': '委托类别',
  'entrust_status': '委托状态',
  'fund_account': '资金帐号',
  'error_no': '错误号',
  'error_info': '错误原因'}]

卖出:

user.sell('162411', price=0.55, amount=100)

撤单

佣金宝

user.cancel_entrust('委托单号', '股票代码')

查询交割单

需要注意通常券商只会返回有限天数最新的交割单，如查询2015年整年数据, 华泰只会返回年末的90天的交割单

user.exchangebill   # 查询最近30天的交割单

user.get_exchangebill('开始日期', '截止日期')   # 指定查询时间段, 日期格式为 "20160214"

return

{["entrust_bs": "操作", # "1":"买入", "2":"卖出", " ":"其他"
  "business_balance": "成交金额",
  "stock_name": "证券名称",
  "fare1": "印花税",
  "occur_balance": "发生金额",
  "stock_account": "股东帐户",
  "business_name": "摘要", # "证券买入", "证券卖出", "基金拆分", "基金合并", "交收证券冻结", "交收证券冻结取消", "开放基金赎回", "开放基金赎回返款", "基金资金拨入", "基金资金拨出", "交收资金冻结取消", "开放基金申购"
  "farex": "",
  "fare0": "手续费",
  "stock_code": "证券代码",
  "occur_amount": "成交数量",
  "date": "成交日期",
  "post_balance": "本次余额",
  "fare2": "其他杂费",
  "fare3": "",
  "entrust_no": "合同编号",
  "business_price": "成交均价",
]}

基金申购

银河

user.fundpurchase(stock_code, amount):

基金赎回

银河

user.fundredemption(stock_code, amount):

基金认购

银河

user.fundsubscribe(stock_code, amount):

基金分拆

银河

user.fundsplit(stock_code, amount):

基金合并

银河

user.fundmerge(stock_code, amount):

查询当日成交

佣金宝

user.current_deal

return

[{'business_amount': '成交数量',
'business_price': '成交价格',
'entrust_amount': '委托数量',
'entrust_bs': '买卖方向',
'stock_account': '证券帐号',
'fund_account': '资金帐号',
'position_str': '定位串',
'business_status': '成交状态',
'date': '发生日期',
'business_type': '成交类别',
'business_time': '成交时间',
'stock_code': '证券代码',
'stock_name': '证券名称'}]

佣金宝

user.get_ipo_limit('申购代码')

return

{'high_amount': '最高申购股数',
'enable_amount': '申购额度',
'last_price': '发行价',}

查询今天可以申购的新股信息

from easytrader import helpers
ipo_data = helpers.get_today_ipo_data()
print(ipo_data)

return

[{'stock_code': '股票代码',
  'stock_name': '股票名称',
  'price': 发行价,
  'apply_code': '申购代码'}]

雪球组合调仓

user.adjust_weight('000001', 10)

跟踪 joinquant 的模拟交易

初始化跟踪的 trader

这里以雪球为例, 也可以使用银河之类 easytrader 支持的券商

xq_user = easytrader.use('xq')
xq_user.prepare('xq.json')

初始化跟踪 joinquant 的 follower

jq_follower = easytrader.follower('jq')
jq_follower.login(user='jq用户名', password='jq密码')

连接 follower 和 trader

jq_follower.follow(xq_user, 'jq的模拟交易url')

注: jq的模拟交易url指的是对应模拟交易对应的可以查看持仓, 交易记录的页面, 类似 https://www.joinquant.com/algorithm/live/index?backtestId=xxx

正常会输出

enjoy it

跟踪 雪球的组合

初始化跟踪的 trader

同上

初始化跟踪 雪球组合 的 follower

xq_follower = easytrader.follower('xq')
xq_follower.login(user='xq用户名', password='xq密码')

连接 follower 和 trader

xq_follower.follow(xq_user, 'xq组合ID，类似ZH123456', total_assets=100000)

注: 雪球组合是以百分比调仓的， 所以需要额外设置组合对应的资金额度

• 这里可以设置 total_assets, 为当前组合的净值对应的总资金额度, 具体可以参考参数说明
• 或者设置 initial_assets, 这时候总资金额度为 initial_assets * 组合净值

多用户跟踪多策略

jq_follower.follow(users=[xq_user, yh_user], strategies=['组合1', '组合2'], total_assets=[10000, 10000])

目录下产生的 cmd_cache.pk

这是用来存储历史执行过的交易指令，防止在重启程序时重复执行交易过的指令，可以通过 jq_follower.follow(xxx, cmd_cache=False) 来关闭

命令行模式

登录

 python cli.py --use ht --prepare ht.json 

注: 此时会生成 account.session 文件保存生成的 user 对象

获取余额 / 持仓 / 以及其他变量

 python cli.py --get balance

买卖 / 撤单

 python cli.py --do buy 162411 0.450 100

查看帮助

 python cli.py --help

Q&A

Question

哪里可以找到对应的 ht.json , xq.json 的说明

Answer

这个文件需要自己新建，对应的格式在 github 项目的根目录下有对应的模板

Question

如何关闭 debug 日志的输出

Answer

user = easytrader.use('ht', debug=False)

Question

编辑完配置文件，运行后出现 json 解码报错的信息。类似于下面

raise JSONDecodeError("Expecting value", s, err.value) from None

JSONDecodeError: Expecting value

Answer

请勿使用 记事本 编辑账户的 json 配置文件，推荐使用 notepad++ 或者 sublime text

其他

软件实现原理