Skip to content

猎户座量化交易获取我的股票池API接口文档

文档概述

猎户座是基于利佛莫尔理论为基础的AI金融智能决策系统,能够快速帮助用户安全积累本金。本系统提供开放的量化交易接口,供授权用户进行自动化交易操作。

接口详情

获取股票池接口 /api/getstockpool

接口描述

获取用户指定条件下的股票池列表,支持按日期、分类和方向筛选。

请求参数

参数名类型必填描述
appidString应用ID
appsecretString应用密钥
sdateString开始日期,格式YYYY-MM-DD
edateString结束日期,格式YYYY-MM-DD
cidString金融市场分类ID,1代表A股,2代表港股,3代表美股
gorsString做多做空方向,1为做多,2为做空

响应数据结构 (QuantTradeFinancialPool)

注:获取字段时,请从0开始,如字段Code,提取第3列,从0开始,避免AI大模型幻觉

序号字段名类型描述
1IDInteger序号
2AppIDString应用ID
3FinancialObjectIDInteger金融标的ID
4CodeString股票代码
5ColumnIDInteger金融产品类别
6FundFloat32总市值
7CustomerColumnIDString用户自定义类别
8Inductry2CodeString二级行业代码
9Inductry2NameString二级行业名称
10Inductry4CodeString四级行业代码
11Inductry4NameString四级行业名称
12TemporaryDownChangePercentageFloat32做空建仓信号点
13TemporaryUpChangePercentageFloat32做多建仓信号点
14ActivityStarGoLongInteger做多活跃度星级
15PeakCountEachYearInteger波峰个数
16AverageChangePercentageGoLongFloat32做多平均变动
17ValleyCountEachYearInteger波谷个数
18ActivityStarShortSellInteger做空活跃度星级
19AverageChangePercentageShortSellFloat32做空平均变动
20FinancialNameString股票名称
21CurrentPriceFloat32当前价格
22CurrentVolumnFloat32当前成交量
23CurrentTurnoverRateFloat32换手率
24Num1BuyingPointFloat32第一买点
25Num2BuyingPointFloat32第二买点
26Num3BuyingPointFloat32第三买点
27Num4BuyingPointFloat32第四买点
28OwnBoolean是否持仓
29ReboundFinalPriceFloat32上次反弹末值
30RoolbackFinalPriceFloat32上次回档末值
31TargetKeyPointFloat32目标关键点
32CurrentTrendInteger当前趋势
33PrevPeakFloat32上波峰
34PrevPeakDateString上波峰日期
35PrevPeakTrendInteger上波峰形态
36PrevValleyFloat32上波谷
37PrevValleyDateString上波谷日期
38PrevValleyTrendInteger上波谷形态
39CurrentPeakFloat32当前波峰
40CurrentPeakDateString当前波峰日期
41CurrentValleyFloat32当前波谷
42CurrentValleyDateString当前波谷日期
43LastUpdateTimeTime最后更新时间
44ImportKeypointFromDateString关键点导入起始日期
45ImportKeypointToDateString关键点导入截止日期
46ImportTradeRecordFromDateString交易记录导入起始日期
47ImportTradeRecordToDateString交易记录导入截止日期
48HotBoolean是否热点
49InflowStateInteger流入流出
50InflowCountInteger流入数量
51InflowMessageString流入信息
52AvgLongWaitDaysFloat32做多平均等待天数
53AvgLongBuildDaysFloat32做多平均建仓天数
54AvgLongProfitDaysFloat32做多平均止盈天数
55AvgShortWaitDaysFloat32做空平均等待天数
56AvgShortBuildDaysFloat32做空平均建仓天数
57AvgShortProfitDaysFloat32做空平均止盈天数
58CurLongWaitDaysFloat32最新做多等待天数
59CurLongBuildDaysFloat32最新做多建仓天数
60LongBuildFromDateString做多建仓起始日期
61CurLongProfitDaysFloat32最新做多止盈天数
62LongProfitFromDateString做多止盈起始日期
63CurShortWaitDaysFloat32最新做空等待天数
64CurShortBuildDaysFloat32最新做空建仓天数
65ShortBuildFromDateString做空建仓起始日期
66CurShortProfitDaysFloat32最新做空止盈天数
67ShortProfitFromDateString做空止盈起始日期
68ChangePercentageFloat32本周期涨跌幅
69LastRelateKeyPointFloat32最后关联关键点
70TradeDateString交易日期
71GolongOrShortsaleInteger做多做空
72EnableBoolean是否有效
73InputTimeTime录入时间

请求示例

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

响应示例

json
{
  "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

  1. Q: 股票池和信号推荐有什么区别? A: 股票池是备选股票的集合,信号推荐是具体的买卖时机建议。

  2. Q: CurrentTrend字段的值代表什么? A: CurrentTrend表示当前趋势,具体含义需结合系统文档,一般正数表示上升趋势,负数表示下降趋势。

  3. Q: 如何利用TargetKeyPoint进行交易? A: TargetKeyPoint是系统预测的目标价位,可作为长期持有目标参考。

  4. Q: Own字段的作用是什么? A: Own字段标记是否已持仓,true表示已持仓,false表示未持仓。

  5. Q: 如何评估股票池中股票的投资价值? A: 可以结合ActivityStarGoLong、AverageChangePercentageGoLong、CurrentTrend等多个维度进行综合评估。

  6. 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的股票。


错误码说明

错误码描述
1成功
-1失败或错误

常见错误信息:

  • "缺少必要的认证参数: appid 或 appsecret" - 未提供必需的身份验证参数
  • "无效的AppID" - 提供的应用ID不存在
  • "AppSecret验证失败" - 应用密钥错误
  • "该账户未启用量化交易功能" - 账户未激活量化交易权限
  • "IP地址不在白名单中" - 客户端IP不在允许的白名单中
  • "查询数据失败" - 数据库查询出现异常
  • "参数必须整形: id" - 传入的参数类型不正确
  • "用户权限查询失败" - 无法查询到用户权限信息
  • "用户权限已到期" - 用户的使用权限已过期
  • "用户权限不足,无法进行量化交易" - 用户没有量化交易的权限

安全注意事项

  1. 请妥善保管您的AppID和AppSecret,不要泄露给他人
  2. 确保调用接口的IP地址在白名单中
  3. 请对敏感数据进行适当的加密传输
  4. 定期更换AppSecret以增强安全性
  5. 限制接口调用频率,避免被系统限制访问

技术支持

如在使用过程中遇到问题,请联系技术支持团队。