webctp是一个基于 openctp-ctp 开发的提供websocket接口的CTP服务。
-
准备Python环境(3.10, 其他版本未测试)
-
克隆 webctp
$ git clone https://github.com/openctp/webctp.git $ cd webctp -
安装依赖库
$ pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host=pypi.tuna.tsinghua.edu.cn
📌 默认使用 openctp-ctp 6.7.2.*, 可通过 requirements.txt 进行修改。
-
自定义配置文件
参考示例 config.example.yaml📌 示例中行情和交易前置地址，默认配置的是 SimNow 7x24 环境， 更多 SimNow 环境参考 openctp环境监控，可根据需要变更为其他支持CTPAPI(官方实现)的柜台环境。
创建自己的行情配置 config_md.yaml :
TdFrontAddress: tcp://180.168.146.187:10130 # 交易前置地址 MdFrontAddress: tcp://180.168.146.187:10131 # 行情前置地址 BrokerID: "9999" AuthCode: "0000000000000000" AppID: simnow_client_test Port: 8080 # the listening port, default 8080 Host: 0.0.0.0 # the bind ip address, default 0.0.0.0 LogLevel: INFO # NOTSET, DEBUG, INFO, WARN, ERROR, CRITICAL
创建自己的交易配置 config_td.yaml :
TdFrontAddress: tcp://180.168.146.187:10130 # 交易前置地址 MdFrontAddress: tcp://180.168.146.187:10131 # 行情前置地址 BrokerID: "9999" AuthCode: "0000000000000000" AppID: simnow_client_test Port: 8081 # the listening port, default 8081 Host: 0.0.0.0 # the bind ip address, default 0.0.0.0 LogLevel: INFO # NOTSET, DEBUG, INFO, WARN, ERROR, CRITICAL
# 启动交易服务
$ python main.py --config=config_td.yaml --app_type=td
# 启动行情服务
$ python main.py --config=config_md.yaml --app_type=mdTODO: 添加postman的请求样例
示例是基于 SimNow 电信1环境, 不同环境的数据存在差异，以下示例数据未必可全部通过, 根据环境调整即可。
登录
请求查询成交
请求查询投资者持仓
请求查询资金账户
请求查询投资者
请求查询交易编码
查询合约保证金率
请求查询合约手续费率
查询期权合约手续费
查询期权交易成本
查询报单手续费率
查询交易所保证金率
查询投资者持仓明细
查询行情
查询产品
查询交易所
查询合约
查询报单
查询最大报单数量
用户口令变更
报单录入（限价单）
报单撤销
# 请求
{
"MsgType": "{method_name}",
"{request_field}": {
"filed1": {value1},
"...": "...",
"fieldn": {valuen}
},
"RequestID": 1
}
# 响应
{
"MsgType": "{rsp_of_method}",
"RspInfo": {
"ErrorID": 0,
"ErrorMsg": "OK"
},
"IsLast": true,
"RequestID": 1
"{response_filed}": {response_body} # 具体参见详细文档
}ErrorID="-400" ErrorMsg="参数有误"
ErrorID="-401" ErrorMsg="未登录"
ErrorID="-404" ErrorMsg="Webctp还未实现该方法"
ErrorID="-1" ErrorMsg="CTP:请求失败"
ErrorID="-2" ErrorMsg="CTP:未处理请求超过许可数"
ErrorID="-3" ErrorMsg="CTP:每秒发送请求数超过许可数"
ErrorID="0" ErrorMsg="CTP:正确"
ErrorID="1" ErrorMsg="CTP:不在已同步状态"
ErrorID="2" ErrorMsg="CTP:会话信息不一致"
ErrorID="3" ErrorMsg="CTP:不合法的登录"
ErrorID="4" ErrorMsg="CTP:用户不活跃"
ErrorID="5" ErrorMsg="CTP:重复的登录"
ErrorID="6" ErrorMsg="CTP:还没有登录"
ErrorID="7" ErrorMsg="CTP:还没有初始化"
ErrorID="8" ErrorMsg="CTP:前置不活跃"
ErrorID="9" ErrorMsg="CTP:无此权限"
ErrorID="10" ErrorMsg="CTP:修改别人的口令"
ErrorID="11" ErrorMsg="CTP:找不到该用户"
ErrorID="12" ErrorMsg="CTP:找不到该经纪公司"
ErrorID="13" ErrorMsg="CTP:找不到投资者"
ErrorID="14" ErrorMsg="CTP:原口令不匹配"
ErrorID="15" ErrorMsg="CTP:报单字段有误"
ErrorID="16" ErrorMsg="CTP:找不到合约"TODO
- 由于精力有限，只进行了SimNow平台的简单的测试，请自行充分测试后再接入生产环境。
- 使用webctp进行实盘交易的后果完全有使用者自行承担。
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent