平安科技
智能投顾项目
RBPAA接口设计说明书
(for 陆金所)
第1.1.2版
平安科技(深圳)有限公司
创新品牌体验团队智能投顾组
二○一七年十月
版本控制信息
版本 日期 拟稿和修改 作者 说明
1.0 2017-10-9 初稿 陈培镇
1.1 2017-12-14 需求更新 陈培镇 新增预测修复需求
?
目录
1 概述 1
2 接口约定 1
3 接口列表 1
4 接口组成 1
5 接口描述 2
5.1 模型 2
5.1.1 大势研判(8001) 2
5.1.2 行业预测(8002) 4
5.1.3 基金预测(8003) 5
5.1.4 预测结果准确性查询(8100) 6
6 附录 7
6.1 CLIENT API 说明 7
1 概述
本文目的是定义并描述“智能投顾系统”(以下简称“RBPAA系统”)与陆金所的联机接口规范。
2 接口约定
接口报文编码格式为“UTF-8”,数据交换格式为JSON,字段类型均为字符串,传输方式为 POST,访问地址为 https://ip:port/app/$tranCode
3 接口列表
接口类型 接口编号 接口名称 是否令牌认证 是否查询类
模型 8001 大势研判接口 否 是
8002 行业预测接口 否 是
8003 基金预测接口 否 是
8100 预测结果准确性查询接口 否 是
4 接口组成
接口报文由两部份组成,报文头和报文体;报文头说明在该小节定义,报文体根据每个接口编号在各自小节中定义。
请求报文头:
数据项 数据域 是否必填 说明
orgId 机构代号 是 310001
tranCode 接口编号 是
version 版本号 是 100
reqChl 请求渠道 是 02
reqTime 请求时间 是 yyyyMMddHHmmssfff
serNum 请求流水号 否 空字符串
token 令牌 否 空字符串
sign 加签值 是 SHA256withRSA2048
响应报文头:
数据项 数据域 说明
tranCode 接口编号
respTime 响应时间 yyyyMMddHHmmssfff
respCode 响应码 00-成功,01-处理中,其他-失败
respMsg 响应消息 接口响应描述信息
sign 加签值 SHA256withRSA2048
5 接口描述
5.1 模型
5.1.1 大势研判(8001)
接口编号: 8001
返回码说明:详见报文头说明。
接口说明:根据接口请求参数“查询日期”,返回该日期所属自然周、自然月或季度最新一次的研判结果,如果研判结果还未出来,则结果为空。
接口请求:
数据项 数据域 是否必填 说明
queryDate 查询日期 是 yyyyMMdd
judgeCycle 研判周期 是 005 - 周
020 - 月
060 - 季
接口返回:
数据项 数据域 说明
judgeDate 研判日期 yyyyMMdd
endDate 截止日期 yyyyMMdd
curCount 本次研判明细数量
curList 本次研判明细列表 List<Dtl80011>
<多笔返回明细>
Dtl80011
数据项 数据域 说明
rsId 研判ID
judgeModel 研判模型 IV – 异质波动率模型
IP – 机构观点模型
AL – 整合模型
capitalType 流通盘类型 L - 大盘
M - 中盘
S - 小盘
indexId 指数代码 对应的指数代码
judgeRs 研判结果 1 - 涨
0 - 平
-1 - 跌
rsDesc 结果描述
tOpen 起始价 研判日期的前收盘价
tClose 截止价 截止日期的收盘价
trueFlag 研判结果准确标志 Y - 准确
N - 不准确
W - 待确认
报文示例:
请求报文:
{"judgeCycle":"005","orgId":"310001","queryDate":"20171208","reqChl":"02","reqTime":"20171016120000999","serNum":null,"sign":"NxbLrtxJqQdVmU9Srx72OmueLv+noLzfEV7r6cuOBWQUWXY0iTKHeAMYd0s5Lj3JAX1eKOvUfehbl38Z2jKZxILpx5SnF53ICT2MQJfvBf5yZ0GYXHagCkc63V5a4/beTi+sp3NjjtU4gy307l0IjKsGtAQ366m1oo57Q8auSxo/4Q3EKCd6AyweN7h22HVOc7p4TT26ymHPEM410hV+ChTtQxhZ8LUxjZX9ScmK7ySTYf+voXeLanR0VBxBJoMkYsYEQ7loM0UGh9jUgU0uo2SjuE0qvv8uVmlPbaK9SSyvf5ix8TPuJPBUN6ocB+KuZQm8WDFo/31vKWNfR1yLsQ==","token":null,"tranCode":"8001","version":"100"}
响应报文:
{"curCount":"9","curList":[{"capitalType":"L","indexId":"000300.SH","judgeModel":"IP","judgeRs":"1","rsDesc":"流通盘:L,研报(家数):17,看涨机构:4,看平机构:12,看跌机构:1","rsId":"100212495707","tClose":"4003.3792","tOpen":"3998.1365","trueFlag":"Y"},{"capitalType":"M","indexId":"000905.SH","judgeModel":"IP","judgeRs":"-1","rsDesc":"流通盘:M,研报(家数):17,看涨机构:0,看平机构:17,看跌机构:0","rsId":"100212495708","tClose":"6203.1433","tOpen":"6316.4072","trueFlag":"Y"},{"capitalType":"S","indexId":"000852.SH","judgeModel":"IP","judgeRs":"-1","rsDesc":"流通盘:S,研报(家数):17,看涨机构:0,看平机构:16,看跌机构:1","rsId":"100212495709","tClose":"7078.0006","tOpen":"7215.7755","trueFlag":"Y"},{"capitalType":"M","indexId":"000905.SH","judgeModel":"AL","judgeRs":"0","rsDesc":"中盘周研判-整合模型:看平","rsId":"100212495718","tClose":"6203.1433","tOpen":"6316.4072","trueFlag":"N"},{"capitalType":"L","indexId":"000300.SH","judgeModel":"AL","judgeRs":"1","rsDesc":"大盘周研判-整合模型:看涨","rsId":"100212495719","tClose":"4003.3792","tOpen":"3998.1365","trueFlag":"Y"},{"capitalType":"S","indexId":"000852.SH","judgeModel":"AL","judgeRs":"0","rsDesc":"小盘周研判-整合模型:看平","rsId":"100212495717","tClose":"7078.0006","tOpen":"7215.7755","trueFlag":"N"},{"capitalType":"L","indexId":"000300.SH","judgeModel":"IV","judgeRs":"1","rsDesc":"大盘周研判-波动率模型:计算结果为3.039042,看涨","rsId":"100212494729","tClose":"4003.3792","tOpen":"3998.1365","trueFlag":"Y"},{"capitalType":"S","indexId":"000852.SH","judgeModel":"IV","judgeRs":"1","rsDesc":"小盘周研判-波动率模型:计算结果为4.224670,看涨","rsId":"100212494727","tClose":"7078.0006","tOpen":"7215.7755","trueFlag":"N"},{"capitalType":"M","indexId":"000905.SH","judgeModel":"IV","judgeRs":"1","rsDesc":"中盘周研判-波动率模型:计算结果为8.614893,看涨","rsId":"100212494728","tClose":"6203.1433","tOpen":"6316.4072","trueFlag":"N"}],"endDate":"20171208","judgeDate":"20171204","respCode":"00","respMsg":"成功","respTime":"20180105140106696","sign":"YN16nutlbqkPsIuY7y3eBlaDJkhVW1ljcm5QmHYYnAakVqBz6J5E0RF5srM4IA5dpgxKJ15oKepcZOPK9YxVA0Q2xfycHDOJmv0vcwlR2vAbBQYMLRY5qBbWDgcdEuTkvuCiP5Py+ysj+vteVtxtWJgZZauKRxFMmxBscUdP7MAnnBpklmW2OsX8TnFem5ZnMMhXinvs6+ofYJsDoaRtMoLIJhgSqSFZZ0F27UKexrk2GcNc9DNLOEapErjuqkOiyU+00YFewzLkzfDdc4gezjOE4uiSv36yXjbkxEvCQrpTzCAzrSA0vjxbUP4L7LqWR4hUP1Fchix7seTQUw2frw==","tranCode":"8001"}
5.1.2 行业预测(8002)
接口编号: 8002
返回码说明:详见报文头说明。
接口说明:根据接口请求参数“查询日期”, 返回该日期所属自然周、自然月或季度最新一次的预测结果,如果预测结果还未出来,则结果为空。
接口请求:
数据项 数据域 是否必填 说明
queryDate 查询日期 是 yyyyMMdd
predictCycle 预测周期 是 005 - 周
020 - 月
060 - 季
industryType 行业级别 是 11 - 中信一级
12 - 中信二级
13 - 中信三级
predictModel 预测模型 否 IP – 机构观点模型(默认)
BI - 交易热度模型
接口返回:
数据项 数据域 说明
predictDate 预测日期 yyyyMMdd
endDate 截止日期 yyyyMMdd
curCount 本次预测明细数量
curList 本次预测明细列表 List<Dtl80021>
<多笔返回明细>
Dtl80021
数据项 数据域 说明
rsId 预测ID
predictModel 预测模型
industryCode 行业代码
predictRs 预测结果 1 - 买入
0 - 持有
-1 - 卖出
-9 - 无数据
rsDesc 结果描述
tOpen 起始价 预测日期的前收盘价
tClose 截止价 截止日期的收盘价
trueFlag 预测准确标志 Y - 准确
N - 不准确
W - 待确认
0 - 无需确认
报文示例:
5.1.3 基金预测(8003)
接口编号: 8003
返回码说明:详见报文头说明。
接口说明:根据接口请求参数“查询日期”, 返回该日期所属自然周、自然月和季度最新一次的预测结果,如果预测结果还未出来,则结果为空。
接口请求:
数据项 数据域 是否必填 说明
queryDate 查询日期 是 yyyyMMdd
predictCycle 预测周期 是 005 - 周
020 - 月
060 - 季
接口返回:
数据项 数据域 说明
predictDate 预测日期 yyyyMMdd
endDate 截止日期 yyyyMMdd
curCount 本次预测明细数量
curList 本次预测明细列表 List<Dtl80031>
<多笔返回明细>
Dtl80031
数据项 数据域 说明
rsId 预测ID
predictModel 预测模型 IV – 基于大势研判异质波动率模型
IP – 基于大势研判机构观点模型
AL – 基于大势研判整合模型
IN – 基于基金持仓个股所属中信一级行业
I2 – 基于基金持仓个股所属中信二级行业
I3 – 基于基金持仓个股所属中信三级行业
fundId 基金代码
predictRs 预测结果 1 - 买入
0 - 持有
-1 - 卖出
-9 - 无数据
rsDesc 结果描述
tOpen 起始价
tClose 截止价
trueFlag 预测准确标志 Y - 准确
N - 不准确
W - 待确认
0 - 无需确认
报文示例:
5.1.4 预测结果准确性查询(8100)
接口编号: 8100
返回码说明:详见报文头说明。
接口说明:
根据请求的rsId列表查询其对应的预测预测准确性结果,一次最多支持500个rsId;
建议可以通过截止日期来确认是否需要做准确性结果查询。
接口请求:
数据项 数据域 是否必填 说明
predictType 预测类型 是 1 – 大势研判
2 – 行业预测
3 – 基金预测
rsIdList 查询列表 是 List<String>
接口返回:
数据项 数据域 说明
count 明细数量
rsList 预测结果明细列表 List<Dtl81002>
<多笔返回明细>
Dtl81002
数据项 数据域 说明
rsId 预测ID
tOpen 起始价
tClose 截止价
trueFlag 预测准确标志 Y - 准确
N - 不准确
W - 待确认
0 - 无需确认
报文
5.1.5 组合分析(1000)
接口编号: 1000
返回码说明:详见报文头说明。
接口说明:
组合分析
接口请求:
数据项 数据域 说明
List<Dtl1000>
Dtl1000
数据项 数据域 是否必填 说明
comboId 组合代码 是
investAmt 投资金额 是
fundId 基金代码 是
ctgId 组合大类 是
nav 购买净值 是
unit 份额 是
income 收益 是
接口返回:
数据项 数据域 说明
List<Dtl10001>
Dtl10001
数据项 数据域 说明
cycle 周期
comboId 组合代码
ctgId 组合大类
comboWeight 组合权重
comboReturn 组合回报
benchmarkWeight 基准权重
benchmarkReturn 基准回报
distEffect 分配效应
selectEffect 选择效应
crossItem 交叉项
报文
5.1.6 个股分析(1001)
接口编号: 1001
返回码说明:详见报文头说明。
接口说明:
个股分析
报文
5.1.7 行业分析(1002)
接口编号: 1002
返回码说明:详见报文头说明。
接口说明:
行业分析
报文
6 附录
6.1 Client API 说明平安科技智能投顾接口设计说明书_陆金所 v1.1.4
原文地址:https://blog.51cto.com/7952376/2363794