ShiPanE-Python-SDK

实盘易（ShiPanE）Python SDK，通达信自动化交易 API。

实盘易是爱股网旗下的股票自动化解决方案；提供基于 HTTP 协议的 RESTFul Service，从而管理通达信等交易终端。

详情见：http://www.iguuu.com/e

交流QQ群：11527956

原理概述
功能介绍
基本用法
定时任务调度
- Windows
  - 安装
  - 配置
  - 运行
  - 升级
  - 日志
- Mac/Linux
  - 安装
  - 配置
  - 运行
  - 升级
聚宽（JoinQuant）集成
- 一. 推送方式
  - 准备工作
  - 步骤
- 二. 抓取方式
  - 准备工作
  - 步骤
米筐（RiceQuant）集成
- 一. 推送方式
  - 准备工作
  - 步骤
- 二. 抓取方式
  - 准备工作
  - 步骤
优矿（Uqer）集成
- 一. 推送方式
- 二. 抓取方式
  - 准备工作
  - 步骤
果仁（Guorn）集成
- 一. 推送方式
- 二. 抓取方式
其他语言 SDK
- C# SDK

原理概述

实盘易通过调用 WINDOWS API 对通达信进行操作。
实盘易提供基于 HTTP 协议的 RESTFul Service/API。
SDK 对 API 进行了封装（由 shipane_sdk/client.py 中的 Client 类实现）。
本地策略或量化交易平台（目前支持聚宽、米筐、优矿）的模拟交易通过调用 SDK 实现自动下单。

功能介绍

简单的实盘易 HTTP API 封装，见 shipane_sdk/client.py
多账号自动新股申购（自动打新）
多账号自动逆回购
定时批量下单
聚宽（JoinQuant）集成
米筐（RiceQuant）集成
优矿（Uqer）集成
果仁（Guorn）集成

基本用法

import logging

import shipane_sdk

logging.basicConfig(level=logging.DEBUG)

client = shipane_sdk.Client(host='localhost', port=8888, key='')
account_info = client.get_account('title:monijiaoyi')
print(account_info)

详见：examples/basic_example.py

定时任务调度

多账号自动申购新股（自动打新）
多账号自动申购转债
多账号自动逆回购
定时批量下单
聚宽（JoinQuant）
- 自动跟单模拟交易（抓取方式）
- 自动同步擂台策略（抓取方式）
米筐（RiceQuant）自动跟单（抓取方式）
优矿（Uqer）自动跟单（抓取方式）

Windows

安装

安装 Python 3.5（建议安装 Anaconda3-4.2.0）
cmd 中运行

正式版	`pip install --no-binary shipane_sdk shipane_sdk`
测试版	`pip install --pre --no-binary shipane_sdk shipane_sdk`

配置

cmd 中运行：explorer %UserProfile%\.shipane_sdk\config
修改 scheduler.ini 中的配置（建议使用Notepad++）

运行

cmd 下运行：shipane-scheduler

升级

cmd 中运行

正式版	`pip install --upgrade --no-deps --no-binary shipane_sdk shipane_sdk`
测试版	`pip install --upgrade --pre --no-deps --no-binary shipane_sdk shipane_sdk`

参考 scheduler-template.ini 修改 scheduler.ini

日志

cmd 中运行：explorer %UserProfile%\AppData\Local\爱股网\实盘易

Mac/Linux

安装

安装 Python 3.5
terminal 中运行

正式版	`pip install --no-binary shipane_sdk shipane_sdk`
测试版	`pip install --pre --no-binary shipane_sdk shipane_sdk`

配置

修改 ~/.shipane_sdk/config/scheduler.ini

运行

terminal 中运行：shipane-scheduler:code:

升级

terminal 中运行

正式版	`pip install --upgrade --no-deps --no-binary shipane_sdk shipane_sdk`
测试版	`pip install --upgrade --pre --no-deps --no-binary shipane_sdk shipane_sdk`

参考 scheduler-template.ini 修改 scheduler.ini

聚宽（JoinQuant）集成

一. 推送方式

适用于云服务器环境，例如阿里云；特点是稳定、高效，集成简单。

准备工作

部署实盘易。
本地测试通过。
远程测试通过。

步骤

下载 scripts/shipane_sdk_installer.ipynb 并上传至“投资研究”根目录。
打开该文件，设置参数：QUANT_NAME = 'joinquant'
查看其它参数并根据需要进行修改。
点击工具栏中的右箭头运行该文件，并检查窗口中打印的日志。
修改 shipane_sdk_config.yaml，升级后需参考 shipane_sdk_config_template.yaml 进行修改。
修改策略代码，可参考如下示例：
- examples/joinquant/simple_strategy.py - 基本跟单用法（侵入式设计，不推荐）
- examples/joinquant/advanced_strategy.py - 高级同步、跟单用法（非侵入式设计，推荐）
- examples/joinquant/new_stocks_purchase.py - 新股申购
- examples/joinquant/convertible_bonds_purchase.py - 转债申购
- examples/joinquant/repo.py - 逆回购

同步操作注意事项：

同步操作根据模拟盘持仓比例对实盘进行调整。
同步操作依赖于“可用”资金。请留意配置文件中“撤销全部订单”相关选项。
“新股申购”不影响“可用”资金，并且不可被撤销，因此不影响同步功能。
同步操作依赖于实盘易 API /adjustments；因此也依赖于“查询投资组合”API，使用前请先做好测试及配置。
同步操作使用“市价单”。
如遇到策略报错“ImportError: No module named shipane_sdk”，请稍后重试。
量化平台模拟交易运行中升级 SDK，需重启生效。

二. 抓取方式

无需云服务器，采用定时轮询的方式，实时性不如"推送方式"。

准备工作

部署实盘易。
测试通过。

步骤

见定时任务调度

米筐（RiceQuant）集成

一. 推送方式

适用于云服务器环境，例如阿里云；特点是稳定、高效，集成简单。

准备工作

部署实盘易。
本地测试通过。
远程测试通过。

步骤

下载 scripts/shipane_sdk_installer.ipynb 并上传至“策略研究”根目录。
打开该文件，设置参数：QUANT_NAME = 'ricequant'
查看其它参数并根据需要进行修改。
点击工具栏中的右箭头运行该文件，并检查窗口中打印的日志。
修改策略代码，可参考如下示例：
- examples/ricequant/simple_strategy.py - 基本用法
- examples/ricequant/advanced_strategy.py - 高级同步用法（非侵入式设计，推荐）
- examples/ricequant/new_stocks_purchase.py - 新股申购
- examples/ricequant/convertible_bonds_purchase.py - 转债申购
- examples/ricequant/repo.py - 逆回购