nopain1573 / tdxtradeserver

TongDaXin Tarde Server 通达信交易服务器

TongDaXin Trade Server

概述

本程序实现了一个服务器，用来接收交易请求，并将请求转发给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

客户端

• python (pytdx)
• Node.JS(javascript) (tdx.js)

构建

本程序使用QT5.9.1开发，使用restbed作为web server实现，使用jsonformoderncpp作为json序列化和反序列化工具，使用conan作为c++依赖库的管理。 请使用兼容c++11的编译器编译（这里我使用的vs2015的编译器，理论上mingw应该也可以）

构建过程

1. 安装python (我的版本是3.5.2)
2. 安装Conan (注意，这里我使用的是0.29.0， 目前不能使用1.x版本)
3. 安装Qt 并配置VS2015 C++ Compiler
4. 配置git
5. 安装cmake
6. 配置git,cmake命令在系统path中可以调用
7. 分别在 ./conan/debug/ 和 ./conan/release/ 目录下执行install.bat

然后打开QT Creator编译即可。

配置

我们可以通过配置文件来配置系统，配置文件可以在如下两个地方被放置

1. [程序运行目录]/TdxTradeServer.ini
2. ~/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, 程序会提供 http://[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("http://127.0.0.1:19820/api", json={"func":"ping"}).text
Out[5]: '{"success":true, "data": "pong"}'

In [6]: requests.get("http://127.0.0.1:19820/status").text
Out[6]: '{"reqnum":1,"success":true}'