easytrader

• 进行自动的程序化股票交易
• 实现自动登录
• 支持命令行调用，方便其他语言适配
• 支持 Python3 / Python2, Linux / Win
• 有兴趣的可以加群 429011814 一起讨论

开发环境 : Ubuntu 16.04 / Python 3.5

相关

量化交流论坛

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

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

捐助: 支付宝 微信

支持券商

• 佣金宝
• 华泰
• 银河 by @ruyiqf
• 广发 by @ruyiqf

模拟交易

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

requirements

pip install -r requirements.txt

华泰 / 佣金宝 的自动登录需要安装以下二者之一， 银河的自动登录需要安装下列的 tesseract：

• JAVA : 推荐, 识别率高，安装简单, 需要命令行下 java -version 可用 (感谢空中园的贡献)
• tesseract : 保证在命令行下 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('yjb') # 佣金宝支持 ['yjb', 'YJB', '佣金宝']

华泰

user = easytrader.use('ht') # 华泰支持 ['ht', 'HT', '华泰']

注: 如果你的华泰账户是以 08 开头，而且可以正常登录，但是其他操作返回 账户记录表不存在 等错误时，请尝试 user = easytrader.use('ht', remove_zero=False)

银河

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

广发

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

登录帐号

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

注:

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

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

• 华泰需要配置 ht.json 填入相关信息, trdpwd 加密后的密码首次需要登录后查看登录 POST 的 trdpwd 值确定
• 佣金宝需要配置 yjb.json 并填入相关信息, 其中的 password 为加密后的 password
• 银河需要配置 yh.json 填入相关信息, trdpwd 加密后的密码首次需要登录后查看登录 POST 的 trdpwd 值确定, 以及登录POST请求里面的hardinfo字段
• 雪球配置中 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('委托单号')

佣金宝

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

银河证券

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

银河证券场内基金功能

基金认购

user.fundsubscribe('基金代码', '基金份额')

基金申购

user.fundpurchase('基金代码', '基金份额')

基金赎回

user.fundredemption('基金代码', '基金份额')

基金合并

user.fundmerge('基金代码', '基金份额')

基金拆分

user.fundsplit('基金代码', '基金份额')

查询交割单

华泰/广发

需要注意通常券商只会返回有限天数最新的交割单，如查询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": "成交均价",
]}

# 未确认的key有, farex, fare3
# 未确认的表头有 结算汇率, 备注

查询当日成交

佣金宝

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.ipo_enable_amount('股票代码')

场内基金赎回(广发)

user.cnjj_redemption('股票代码', '赎回份额')

场内基金申购(广发)

user.cnjj_apply('股票代码', '赎回份额')

广发牛熊宝

牛熊宝查询

user.nxbQueryPrice('基金代码')

牛熊宝单项申报

user.nxbentrust('基金代码', '转入数量', '转换比例', '转换方向')

单日委托

user.nxbQueryEntrust('开始日期,ex:20160515', '结束日期', '查询类型[0:历史， 1:单日]')

单日转换

user.nxbQueryDeliverOfToday()

历史转换

user.nxbQueryHisDeliver()

牛熊宝代码查询

user.queryOfStkCode()

牛熊宝持仓查询

user.queryNXBOfStock()

命令行模式

登录

 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

如何关闭 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

其他

软件实现原理

附录

银河的返回

balance

[{
    '资金帐号': 'x', 
    '参考市值': 10.1, 
    '资金余额': 10.1, 
    '可用资金': 10.1, 
    '总资产': 10.1, 
    '股份参考盈亏': 10.1, 
    '币种': '人民币'
}]

entrust

[{
    '委托时间': '11:11:11', 
    '证券名称': 'x', 
    '成交数量': 100, 
    '股东代码': 'x', 
    '证券代码': 'x', 
    '状态说明': '已成', 
    '委托数量': 100, 
    '委托日期': '20160401', 
    '交易市场': '深A', 
    '撤单数量': 0, 
    '委托价格': 0.999, 
    '委托序号': '12345', 
    '买卖标志': '买入'
}]

position

[{
    '参考市值': 10.1, 
    '参考盈亏': -0.0, 
    '当前持仓': 100, 
    '股份余额': 100, 
    '证券名称': 'x', 
    '参考市价': 0.111, 
    '卖出冻结': 0, 
    '买入冻结': 0, 
    '交易市场': '深A', 
    '证券代码': '123456', 
    '盈亏比例(%)': '0.00%', 
    '股份可用': 100, 
    '股东代码': 'x'
}]