@hbec-public
2016-09-14T01:18:54.000000Z
字数 5151
阅读 687
对外查询接口
自选股 共同关注 条件单 条件单详情 接口文档
| 版本 | 修订人 | 修订日期 | 备注 |
|---|---|---|---|
| V1.0 | 王鑫 | 2016-6-6 | 社区他首页自选及条件单接口 |
在工程pom文件中依赖:hbec-commons-app-inside
<dependency><groupId>hbec</groupId><artifactId>hbec-commons-app-inside</artifactId><version>0.0.3-SNAPSHOT</version><exclusions><exclusion><artifactId>hbec-commons</artifactId><groupId>hbec</groupId></exclusion></exclusions></dependency>
共同关注的股票
接口
IStockFollowQueryService
方法名
queryCommonFollowStockList
参数列表
| 参数名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| visitorId | Integer | Y | 访客ID |
| userId | Integer | Y | 用户ID |
调用示例
List<WarnFollow> commonFollowList = stockFollowQueryService.queryCommonFollowStockList(10, 303348);
返回值
WarnFollow实体
| 属性 | 类型 | 说明 |
|---|---|---|
| stockCode | String | 股票代码 |
| stockName | String | 股票名称 |
他关注的股票
接口
IStockFollowQueryService
方法名
queryFollowStockByPage
参数列表
| 参数名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| visitorId | Integer | Y | 访客ID |
| userId | Integer | Y | 用户ID |
调用示例
PageVo<WarnFollow> pager = new PageVo<WarnFollow>();
pager.setPageNo(pageNo);
pager.setPageSize(pageSize);
PageVo<WarnFollow> userFollowList = stockFollowQueryService.queryFollowStockByPage(10, 303348, pager);
返回值
WarnFollow实体
| 属性 | 类型 | 说明 |
|---|---|---|
| securityType | Integer | 关注类型(3:场内基金 4:股票) |
| stockCode | String | 股票代码 |
| stockName | String | 股票名称 |
共同关注的条件单股票
接口
IStockFollowQueryService
方法名
queryCommonFollowStockConditionList
参数列表
| 参数名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| visitorId | Integer | Y | 访客ID |
| userId | Integer | Y | 用户ID |
调用示例
List<WarnFollow> commonConditionList = stockFollowQueryService.queryCommonFollowStockConditionList(10, 303348);
返回值
WarnFollow实体
| 属性 | 类型 | 说明 |
|---|---|---|
| stockCode | String | 股票代码 |
| stockName | String | 股票名称 |
用户公开的条件单列表
接口
IConditionQueryService
方法名
queryConditionByPage
参数列表
| 参数名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| userId | Integer | Y | 用户ID |
| pager | PageVo<ConditionTradeMarketVO> | Y | 分页查询对象 |
调用示例
PageVo<ConditionTradeMarketVO> pager = new PageVo<ConditionTradeMarketVO>();
pager.setPageNo(pageNo);
pager.setPageSize(pageSize);
PageVo<ConditionTradeMarketVO> pageVo = conditionQueryService.queryConditionByPage(6, pager);
返回值
ConditionTradeMarketVO实体
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| count | int | Y | 总数 |
| pageNo | int | Y | 页码,与传参相同 |
| pageSize | int | Y | 每页数量,与传参相同 |
| hasNextPage | boolean | Y | 是否有下一页数据 |
| list | array | Y | 数据列表 |
| warnId | int | Y | 条件单id |
| stockName | string | Y | 证券名称 |
| stockCode | string | Y | 证券代码 |
| securityType | int | Y | *新增: 证券类型,对应FollowType,数据字典 |
| warnValue | bigDecimal | Y | 条件阈值 |
| upOrDown | string | Y | 1:上涨,0:下跌 |
| costPrice | bigDecimal | N | 成本价,止盈止损单有用 |
| strategyType | string | Y | 策略类型,见数据字典 |
| strategyState | string | Y | 条件单状态,见数据字典 |
| availableDateBegin | string | N | 有效开始时间,为空视为立即有效,格式必须为"2015-11-01" |
| availableDateEnd | string | N | 截止有效日期,为空视为永久有效,格式必须为"2015-11-11" |
| availableTimeBegin | string | N | 有效时间起点,为空视为9:30,格式必须为"10:00:00" |
| availableTimeEnd | string | N | 有效时间终点,为空视为15:00,格式必须为"14:30:00" |
| exchange | string | Y | 交易所,SH:上海、SZ:深圳 |
| direction | int | Y | 委托类别,1:买入、2:卖出 |
| entrustAmount | int | Y | 委托数量,单位为股 |
| entrustPrice | bigDecimal | Y | 委托价格 |
| exchangeMethod | int | Y | 交易方式 0:提醒交易 1:自动交易 |
| entrustStrategy | int | N | 自动委托策略,不传视为0,见数据字典 |
| currentPrice | bigDecimal | Y | 证券当前价 |
| changesPercent | bigDecimal | Y | 证券当前涨跌幅 |
| profitPercent | bigDecimal | N | 实时收益率,仅止盈止损单有用 |
| profitPercentDesc | string | N | (3.1.5)字符串类型的实时收益率,解决正无穷大问题,如果首字符为负号请显示绿色,其他为红色 |
| strategyProperties | Object | N | 实时状态 |
| monitorPrice | string | Y | 监控价-不需要处理小数点 |
| openness | int | Y | 公开状态,0:不公开(默认)、1:公开 |
条件单详情
接口
IConditionQueryService
方法名
queryConditionDetail
参数列表
| 参数名 | 类型 | 不可为空 | 说明 |
|---|---|---|---|
| userId | Integer | Y | 用户ID,防止他人查询用户条件单 |
| warnId | Integer | Y | 条件单ID |
调用示例
ConditionTradeDetailVo conditionTradeDetail = conditionQueryService.queryConditionDetail(6, 13098);
返回值
ConditionTradeDetailVo实体
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| currentPrice | bigDecimal | Y | 证券当前价 |
| monitorPrice | string | Y | 监控价-不需要处理小数点 |
| changePercent | bigDecimal | Y | 证券当前涨跌幅 |
| profitPercent | bigDecimal | N | 实时收益率,仅止盈止损单有用 |
| stockName | string | Y | 证券名称 |
| warnValue | string | Y | 初始基准价 |
| stockCode | string | Y | 证券代码 |
| strategyType | string | Y | 策略类型,见数据字典 |
| strategyState | string | Y | 条件单状态,见数据字典 |
| warnId | int | Y | 条件单id |
| securityType | int | Y | *新增: 证券类型,对应FollowType,数据字典 |
| direction | int | Y | 委托类别,1:买入、2:卖出,3:双向 |
| warnValue | bigDecimal | Y | 条件阈值 |
| upOrDown | string | Y | 1:上涨,0:下跌 |
| entrustStrategy | int | N | 自动委托策略,见数据字典 |
| availableDateBegin | string | N | 有效开始时间,为空视为立即有效 |
| availableDateEnd | string | N | 截止有效日期,为空视为永久有效 |
| availableTimeBegin | string | N | 有效时间起点,为空视为9:30 |
| availableTimeEnd | string | N | 有效时间终点,为空视为15:00 |
| entrusts | array | Y | 相关委托记录(只有当日委托才有委托记录) |
| code | String | Y | 股票代码 |
| name | String | Y | 股票名称 |
| exchange | String | Y | 交易所 |
| entrustType | int | Y | 委托类别,1:买入、2:卖出 |
| entrustAmount | int | Y | 委托数量 |
| entrustPrice | BigDecimal | Y | 委托价格 |
| frozen | BigDecimal | Y | 冻结资金 |
| entrustDate | int | Y | 委托时间,毫秒值 |
| entrustCode | int | Y | 委托号 |
| isDelete | String | Y | 条件单是否删除标志:(0正常 1 已删除) |
| entrustResultCode | int | N | 委托结果code,见下方数据字典entrustResultCode |
| entrustResultMsg | String | Y | 委托结果说明 |
| entrustNote | String | N | 结果说明(代表失败原因) |
| abossCode | int | Y | 调用aboss下单返回的code,1 :委托成功,0:委托失败,成功使用entrustResultMsg,失败使用abossMsg |
| abossMsg | string | Y | 调用aboss下单返回的msg |
| createTime | long | Y | 触发时间 |
| hasRevoke | boolean | Y | 可撤单标志 false:不能,true:能,仅限于今日委托接口 |
| openness | int | Y | 公开状态,0:不公开(默认)、1:公开 |
| 值 | 含义 |
|---|---|
| 0 | 草稿(仅2.x) |
| 1 | 待触发 |
| 2 | 暂停 |
| 3 | 已触发 |
| 4 | 过期 |
| 5 | 异常终止 |
| 值 | 含义 |
|---|---|
| 3 | 场内基金 |
| 4 | 股票 |
| 5 | 指数 |
| 值 | 含义 |
|---|---|
| 3 | 场内基金 |
| 4 | 股票 |
| 5 | 指数 |
| 值 | 说明 |
|---|---|
| 1 | 价格条件 |
| 3 | 当日涨跌幅 |
| 4 | 开收盘 |
| 5 | 定时 |
| 6 | 止损止盈 |
| 7 | 拐点 |
| 8 | 分批 |
| 9 | 网格 |
| 值 | 说明 |
|---|---|
| 0 | 未申报 |
| 1 | 正在申报 |
| 2 | 已申报未成交 |
| 3 | 非法委托 |
| 4 | 申请资金授权中 |
| 5 | 部分成交 |
| 6 | 全部成交 |
| 7 | 部成部撤 |
| 8 | 全部撤单 |
| 9 | 撤单未成 |
| 10 | 等待人工申报 |
| 值 | 说明 |
|---|---|
| 未申报 | 0 |
| 委托失败 | 3 |
| 委托中 | 1、2、4、10 |
| 已成,未成 | 5 |
| 已成交 | 6 |
| 已成,已撤 | 7 |
| 已撤单 | 8 |
| 撤单中 | 99 |
| 撤单失败 | 9 |
| 值 | 说明 |
|---|---|
| 0 | 用户输入限价挂单,默认值 |
| 1 | 按最新价挂单 |
| 2-6 | 分别为卖五到卖一,卖五对应2,卖一对应6 |
| 7-11 | 分别为买一到买五,买五对应11,买一对应7 |
分类 触发条件文案1 触发条件文案2 备注1 备注2
价格条件单 股价达到X元及以上 股价达到X元及以下 根据现价和目标价高低确定,现价<目标价,代表及以上 买入卖出根据图标表达
时间条件单 交易时间达到XXXX年XX月XX日XX点XX分 时间为24小时制 买入卖出根据图标表达
涨跌幅条件单 涨跌幅达到+X%及以上 涨跌幅达到-X%及以下 根据正负号确定,正代表及以上 买入卖出根据图标表达
止损止盈条件单 持仓收益率达到+X%及以上 持仓收益率达到-X%及以下 根据正负号确定,正代表及以上 都是卖出,图标区分止损止盈
拐点买入 股价低于X元后,出现累计反弹+Y% 用户如果用跌幅表达第一个关键条件,仍转化成股价提示 买入根据图标表达
回落卖出 股价高于X元后,出现累计回落-Y% 用户如果用跌幅表达第一个关键条件,仍转化成股价提示 卖出根据图标表达
分批建仓 股价低于X元后,每次下跌-Y%买入,最大买入数量Z股 用户如果用跌幅表达第一个关键条件,仍转化成股价提示 买入根据图标表达
分批出货 股价高于X元后,每次上涨+Y%卖出,最大卖出数量Z股 用户如果用跌幅表达第一个关键条件,仍转化成股价提示 卖出根据图标表达
区间交易 "价格区间10元~20元;
上升+10.11%,回落-1.01%,卖出;
下跌-10.11%,反弹+1.02%,买入;
倍数委托;" "价格区间10元~20元;
上升+10.11%,卖出;
下跌-10.11%,买入;
倍数委托;" 带拐点和不带拐点的区别 双向交易图标表达