本程序实现了一个服务器,用来接收交易请求,并将请求转发给trade.dll,使其可以通过rest api 被其它程序调用。
注意,注意,注意: 本程序不提供trade.dll文件,仅仅调用该dll库进行交易,并将其封装成rest api使用,
我们也不会提供任何trade.dll文件给使用者(关于trade.dll,请自行百度\谷歌)
如需技术支持,可以想办法联系我。
结构图
+--------------------------------------------------------------+
| Your Quant or Other System |
| |
| |
| +----------------------+ +----------------------------------+
| | | | ||
| | Python client Api | | Other Language Apis ||
| | pytdx | | ||
| | | | ||
| | | | ||
| +----------------------+ +----------------------------------+
| |
| |
+----------------------------+---^-----------------------------+
| |
+----------------------------v---+-----------------------------+
| |
| TongDaXin Trade SerVer Listening : 10092 port |
| + |
| | +---------------------+ |
| | | | |
| +----->+ Trade.dll | |
| | | |
| | | |
| + +---------------------+ |
+--------------------------------^-----------------------------+
| |
+----------------------------v---+-----------------------------+
| |
| Tong Da Xin Servers |
| |
| |
| |
+--------------------------------------------------------------+
方法1: https://github.com/rainx/TdxTradeServer/releases 方法2: (使用Python)
安装pytdx
> pip install pytdx
安装配置服务器
> get_tts
本程序使用QT5.9.1开发,使用restbed
作为web server实现,使用jsonformoderncpp
作为json序列化和反序列化工具,使用conan
作为c++依赖库的管理。 请使用兼容c++11
的编译器编译(这里我使用的vs2015的编译器,理论上mingw应该也可以)
- 安装python (我的版本是3.5.2)
- 安装Conan (注意,这里我使用的是0.29.0, 目前不能使用1.x版本)
- 安装Qt 并配置VS2015 C++ Compiler
- 配置git
- 安装cmake
- 配置git,cmake命令在系统path中可以调用
- 分别在
./conan/debug/
和./conan/release/
目录下执行install.bat
然后打开QT Creator编译即可。
我们可以通过配置文件来配置系统,配置文件可以在如下两个地方被放置
- [程序运行目录]/TdxTradeServer.ini
- ~/TdxTradeServer/TdxTradeServer.ini , ~ 代表当前用户的主目录
配置文件Demo
单账号版本,但账号版本需要生成账号对应的trade.dll文件
bind=10.11.5.175 ; 绑定的ip地址,默认是127.0.0.1
port=10092 ; 绑定的端口
trade_dll_path=D:\\trade_rainx.dll ;一份可以使用的trade.dll文件
transport_enc_key=4f1cf3fec4c84c84 ; 可选, aes加密秘钥
transport_enc_iv=0c78abc083b011e7 ; 可选, aes加密iv
多账号版本,多账号版本只需指定一份有效的trade.dll文档(不必绑定你的账号)
bind=10.11.5.175 ; 绑定的ip地址,默认是127.0.0.1
port=10092 ; 绑定的端口
trade_dll_path=D:\\trade_template.dll ;trade.dll文件, 可以使绑定任意账号的版本,程序会在运行时动态绑定你的账号,所以这里无须预先绑定账号
transport_enc_key=4f1cf3fec4c84c84 ; 可选, aes加密秘钥
transport_enc_iv=0c78abc083b011e7 ; 可选, aes加密iv
multiaccount=true ; 设置多用户版本开启
dlls_path=D:\\dlls ; 绑定的用户dlls所在目录,注意必须是有效的目录
preload_accounts=880001yyyyyy,880001xxxxxxx ; 预先家在德账号列表(建议设置),将在程序启动的时候预先生成绑定账号并载入,提高登入速度。
注意,后面的加密选项为可选,如果transport_enc_key
或者 transport_enc_iv
不提供的话,将使用明文和client api
通讯,请注意和client api
保持一致。 如果您跨机器调用接口,建议使用加密功能,并且,请生成随即密钥和iv, 注意,我们这里key
和iv
必须是16
个字节
服务器端通过restbed
实现了一个webserver, 程序会提供 https://[your_bind]:[your_port]/api
endpoint, 所有的交互都由客户端通过HTTP POST
到本endpoint 实现。
- 请求的内容(payload)放在Request的Body中
- 应答的内容(payload)放在Response的Body中
- 在非加密的情况下,payload 使用json序列化方式传输
- 在加密情况下,payload 使用
URLENCODE(BASE64(AES128_CBC(JSON(PAYLOAD))))
结构加密传输,双方都采用相同方式加密解密
请求的内容结构如下
{
"func": "one_function",
"params": {
"param1": "p1",
"param2": "p2"
}
}
应答的结构如下
{
"success": true,
"data": {
....
},
"error": "some errors only appear when success is False"
}
假设端口为 19820
In [5]: requests.post("https://127.0.0.1:19820/api", json={"func":"ping"}).text
Out[5]: '{"success":true, "data": "pong"}'
In [6]: requests.get("https://127.0.0.1:19820/status").text
Out[6]: '{"reqnum":1,"success":true}'