猎户座量化交易获取我的股票池API接口文档
文档概述
猎户座是基于利佛莫尔理论为基础的AI金融智能决策系统,能够快速帮助用户安全积累本金。本系统提供开放的量化交易接口,供授权用户进行自动化交易操作。
接口详情
获取股票池接口 /api/getstockpool
接口描述
获取用户指定条件下的股票池列表,支持按日期、分类和方向筛选。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appid | String | 是 | 应用ID |
| appsecret | String | 是 | 应用密钥 |
| sdate | String | 否 | 开始日期,格式YYYY-MM-DD |
| edate | String | 否 | 结束日期,格式YYYY-MM-DD |
| cid | String | 否 | 金融市场分类ID,1代表A股,2代表港股,3代表美股 |
| gors | String | 否 | 做多做空方向,1为做多,2为做空 |
响应数据结构 (QuantTradeFinancialPool)
注:获取字段时,请从0开始,如字段Code,提取第3列,从0开始,避免AI大模型幻觉
| 序号 | 字段名 | 类型 | 描述 |
|---|---|---|---|
| 1 | ID | Integer | 序号 |
| 2 | AppID | String | 应用ID |
| 3 | FinancialObjectID | Integer | 金融标的ID |
| 4 | Code | String | 股票代码 |
| 5 | ColumnID | Integer | 金融产品类别 |
| 6 | Fund | Float32 | 总市值 |
| 7 | CustomerColumnID | String | 用户自定义类别 |
| 8 | Inductry2Code | String | 二级行业代码 |
| 9 | Inductry2Name | String | 二级行业名称 |
| 10 | Inductry4Code | String | 四级行业代码 |
| 11 | Inductry4Name | String | 四级行业名称 |
| 12 | TemporaryDownChangePercentage | Float32 | 做空建仓信号点 |
| 13 | TemporaryUpChangePercentage | Float32 | 做多建仓信号点 |
| 14 | ActivityStarGoLong | Integer | 做多活跃度星级 |
| 15 | PeakCountEachYear | Integer | 波峰个数 |
| 16 | AverageChangePercentageGoLong | Float32 | 做多平均变动 |
| 17 | ValleyCountEachYear | Integer | 波谷个数 |
| 18 | ActivityStarShortSell | Integer | 做空活跃度星级 |
| 19 | AverageChangePercentageShortSell | Float32 | 做空平均变动 |
| 20 | FinancialName | String | 股票名称 |
| 21 | CurrentPrice | Float32 | 当前价格 |
| 22 | CurrentVolumn | Float32 | 当前成交量 |
| 23 | CurrentTurnoverRate | Float32 | 换手率 |
| 24 | Num1BuyingPoint | Float32 | 第一买点 |
| 25 | Num2BuyingPoint | Float32 | 第二买点 |
| 26 | Num3BuyingPoint | Float32 | 第三买点 |
| 27 | Num4BuyingPoint | Float32 | 第四买点 |
| 28 | Own | Boolean | 是否持仓 |
| 29 | ReboundFinalPrice | Float32 | 上次反弹末值 |
| 30 | RoolbackFinalPrice | Float32 | 上次回档末值 |
| 31 | TargetKeyPoint | Float32 | 目标关键点 |
| 32 | CurrentTrend | Integer | 当前趋势 |
| 33 | PrevPeak | Float32 | 上波峰 |
| 34 | PrevPeakDate | String | 上波峰日期 |
| 35 | PrevPeakTrend | Integer | 上波峰形态 |
| 36 | PrevValley | Float32 | 上波谷 |
| 37 | PrevValleyDate | String | 上波谷日期 |
| 38 | PrevValleyTrend | Integer | 上波谷形态 |
| 39 | CurrentPeak | Float32 | 当前波峰 |
| 40 | CurrentPeakDate | String | 当前波峰日期 |
| 41 | CurrentValley | Float32 | 当前波谷 |
| 42 | CurrentValleyDate | String | 当前波谷日期 |
| 43 | LastUpdateTime | Time | 最后更新时间 |
| 44 | ImportKeypointFromDate | String | 关键点导入起始日期 |
| 45 | ImportKeypointToDate | String | 关键点导入截止日期 |
| 46 | ImportTradeRecordFromDate | String | 交易记录导入起始日期 |
| 47 | ImportTradeRecordToDate | String | 交易记录导入截止日期 |
| 48 | Hot | Boolean | 是否热点 |
| 49 | InflowState | Integer | 流入流出 |
| 50 | InflowCount | Integer | 流入数量 |
| 51 | InflowMessage | String | 流入信息 |
| 52 | AvgLongWaitDays | Float32 | 做多平均等待天数 |
| 53 | AvgLongBuildDays | Float32 | 做多平均建仓天数 |
| 54 | AvgLongProfitDays | Float32 | 做多平均止盈天数 |
| 55 | AvgShortWaitDays | Float32 | 做空平均等待天数 |
| 56 | AvgShortBuildDays | Float32 | 做空平均建仓天数 |
| 57 | AvgShortProfitDays | Float32 | 做空平均止盈天数 |
| 58 | CurLongWaitDays | Float32 | 最新做多等待天数 |
| 59 | CurLongBuildDays | Float32 | 最新做多建仓天数 |
| 60 | LongBuildFromDate | String | 做多建仓起始日期 |
| 61 | CurLongProfitDays | Float32 | 最新做多止盈天数 |
| 62 | LongProfitFromDate | String | 做多止盈起始日期 |
| 63 | CurShortWaitDays | Float32 | 最新做空等待天数 |
| 64 | CurShortBuildDays | Float32 | 最新做空建仓天数 |
| 65 | ShortBuildFromDate | String | 做空建仓起始日期 |
| 66 | CurShortProfitDays | Float32 | 最新做空止盈天数 |
| 67 | ShortProfitFromDate | String | 做空止盈起始日期 |
| 68 | ChangePercentage | Float32 | 本周期涨跌幅 |
| 69 | LastRelateKeyPoint | Float32 | 最后关联关键点 |
| 70 | TradeDate | String | 交易日期 |
| 71 | GolongOrShortsale | Integer | 做多做空 |
| 72 | Enable | Boolean | 是否有效 |
| 73 | InputTime | Time | 录入时间 |
请求示例
POST http://www.deephunt.com.cn/api/getstockpool Content-Type: application/x-www-form-urlencoded
appid=test_app_id&appsecret=test_app_secret&sdate=2023-01-01&edate=2023-12-31&cid=1&gors=1
响应示例
{
"code": 1,
"message": "success",
"data": [
{
"ID": 1,
"AppID": "hunt6da290c4c4b93847",
"FinancialObjectID": 10211,
"Code": "sz300100",
"ColumnID": 1,
"CustomerColumnID": "115",
"Inductry2Code": "2510",
"Inductry2Name": "乘用车及零部件",
"Inductry4Code": "25101020",
"Inductry4Name": "汽车内饰与外饰",
"TemporaryDownChangePercentage": 0,
"TemporaryUpChangePercentage": 0,
"ActivityStarGoLong": 11,
"PeakCountEachYear": 11,
"AverageChangePercentageGoLong": 0.2026,
"ValleyCountEachYear": 11,
"ActivityStarShortSell": -0.1662,
"AverageChangePercentageShortSell": 0,
"FinancialName": "双林股份",
"CurrentPrice": 30.57,
"CurrentVolumn": 0,
"CurrentTurnoverRate": 0,
"Num1BuyingPoint": 30.5601,
"Num2BuyingPoint": 30.8568,
"Num3BuyingPoint": 31.1535,
"Num4BuyingPoint": 31.4502,
"Own": false,
"ReboundFinalPrice": 0,
"RoolbackFinalPrice": 0,
"TargetKeyPoint": 38.12,
"CurrentTrend": 5,
"PrevPeak": 34.9,
"PrevPeakDate": "2026-02-13",
"PrevPeakTrend": 4,
"PrevValley": 29.67,
"PrevValleyDate": "2026-02-2",
"PrevValleyTrend": 5,
"CurrentPeak": 0,
"CurrentPeakDate": "",
"CurrentValley": 29.67,
"CurrentValleyDate": "2026-03-20",
"LastUpdateTime": "2026-04-01 15:15",
"ImportKeypointFromDate": "2024-04-16",
"ImportKeypointToDate": "2026-04-01",
"ImportTradeRecordFromDate": "2024-04-16",
"ImportTradeRecordToDate": "2026-04-01",
"Hot": 0,
"InflowState": 2,
"InflowCount": 0,
"InflowMessage": "",
"AvgLongWaitDays": 1.6,
"AvgLongBuildDays": 2.6667,
"AvgLongProfitDays": 4.6,
"AvgShortWaitDays": 1.3333,
"AvgShortBuildDays": 3.8421,
"AvgShortProfitDays": 5.0435,
"CurLongWaitDays": 0,
"CurLongBuildDays": 8,
"LongBuildFromDate": "2026-03-23",
"CurLongProfitDays": 0,
"LongProfitFromDate": "",
"CurShortWaitDays": 0,
"CurShortBuildDays": 0,
"ShortBuildFromDate": "",
"CurShortProfitDays": 0,
"ShortProfitFromDate": "",
"ChangePercentage": 3.0334,
"LastRelateKeyPoint": 29.67,
"TradeDate": "2026-03-23",
"GolongOrShortsale": 1,
"Enable": true,
"InputTime": "2026-03-23 21:56"
}
]
}常见问题FAQ
Q: 股票池和信号推荐有什么区别? A: 股票池是备选股票的集合,信号推荐是具体的买卖时机建议。
Q: CurrentTrend字段的值代表什么? A: CurrentTrend表示当前趋势,具体含义需结合系统文档,一般正数表示上升趋势,负数表示下降趋势。
Q: 如何利用TargetKeyPoint进行交易? A: TargetKeyPoint是系统预测的目标价位,可作为长期持有目标参考。
Q: Own字段的作用是什么? A: Own字段标记是否已持仓,true表示已持仓,false表示未持仓。
Q: 如何评估股票池中股票的投资价值? A: 可以结合ActivityStarGoLong、AverageChangePercentageGoLong、CurrentTrend等多个维度进行综合评估。
Q: CustomerColumnID是什么,如何使用? A: CustomerColumnID是用户自定义分类ID,允许用户将股票或其他金融产品进行自定义分类管理。它支持多种股票池选择,每个数字代表不同的股票池:
- A股股票池:
- 112: 沪深300 A股市场的核心代表,也是最符合"权重股"定义的指数。由沪深两市中规模最大、流动性最好的300只股票组成,覆盖了A股约60%的总市值
- 113: 上证50 超大蓝筹的集中营。从上海证券交易所中挑选规模和成交额最大的50只股票,是沪深300的子集
- 114: 中证500 中盘成长的典范。由剔除沪深300成分股后,总市值排名前500的股票组成。它是A股中盘股的核心指数
- 115: 中证1000 小盘股的代表。由剔除中证800(沪深300+中证500)成分股后,规模偏小但流动性较好的1000只股票组成
- 116: 创业板指 创新成长板块的旗帜。从创业板中选取流通市值最大、流动性最好的100家公司
- 117: 科创50 硬科技核心阵地。从科创板中选取市值大、流动性好的50只证券
- 118: 北证50 专精特新小巨人。从北交所选取规模大、流动性好的最具市场代表性的50只上市公司证券
- 港股股票池:
- 119: 恒生指数 港股蓝筹标杆。由香港联合交易所市值最大及成交最活跃的50只股票组成,代表了港股市场的核心资产
- 120: 国企指数 港股中资企业的代表。由在香港上市的中国内地企业中规模最大、流动性最好的股票组成
- 121: 香港创业板 香港创业板的核心成分股,代表了香港市场的创新成长力量
- 122: 港股科技 港股科技板块的代表。由香港上市的科技类企业组成,包括互联网、电子等行业
- 美股股票池:
- 123: 道琼斯工业指数 美国市场的蓝筹股指数,由30家著名的美国公司股票组成,代表了美国经济的核心企业
- 124: 纳斯达克100 纳斯达克100指数,包含纳斯达克交易所中100家最大的非金融类公司,以科技股为主
- 125: 标普500 标普500指数,由美国500家大型上市公司组成,是衡量美国股市整体表现的重要指标
- 126: 罗素2000 罗素2000指数,代表了美国小型上市公司的表现,波动较大但成长潜力高
- 127: 中国概念 中国概念指数,代表了中国市场的核心资产,包括金融、科技等行业
- 0: 不限制股票池,所有股票都可能被推荐
多个股票池可以用逗号分隔,如"112,113"表示同时包含沪深300和上证50的股票。
- A股股票池:
错误码说明
| 错误码 | 描述 |
|---|---|
| 1 | 成功 |
| -1 | 失败或错误 |
常见错误信息:
- "缺少必要的认证参数: appid 或 appsecret" - 未提供必需的身份验证参数
- "无效的AppID" - 提供的应用ID不存在
- "AppSecret验证失败" - 应用密钥错误
- "该账户未启用量化交易功能" - 账户未激活量化交易权限
- "IP地址不在白名单中" - 客户端IP不在允许的白名单中
- "查询数据失败" - 数据库查询出现异常
- "参数必须整形: id" - 传入的参数类型不正确
- "用户权限查询失败" - 无法查询到用户权限信息
- "用户权限已到期" - 用户的使用权限已过期
- "用户权限不足,无法进行量化交易" - 用户没有量化交易的权限
安全注意事项
- 请妥善保管您的AppID和AppSecret,不要泄露给他人
- 确保调用接口的IP地址在白名单中
- 请对敏感数据进行适当的加密传输
- 定期更换AppSecret以增强安全性
- 限制接口调用频率,避免被系统限制访问
技术支持
如在使用过程中遇到问题,请联系技术支持团队。
