猎户座量化交易API接口文档

文档概述

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

接口通用规范

认证机制

所有接口都需要进行身份验证，验证参数包括：

appid: 应用ID，由系统分配
appsecret: 应用密钥，由系统分配

权限校验

系统会对每个请求进行以下权限校验：

检测用户权限是否到期
检测用户是否具备量化交易权限

通用请求格式

POST http://www.deephunt.com.cn/api/endpoint Content-Type: application/x-www-form-urlencoded

appid=your_app_id&appsecret=your_app_secret&other_params...

通用响应格式

json

{
  "code": 1,
  "message": "success",
  "data": {}
}

code: 业务状态码，1表示成功，-1表示失败
message: 响应消息
data: 具体数据内容

接口详情

1. 获取今天买入股票接口 `/api/getbuystock`

接口描述

获取用户指定条件下的买入股票列表，仅返回做多状态且指定结果状态的订单。

请求参数

参数名	类型	必填	描述
appid	String	是	应用ID
appsecret	String	是	应用密钥
sdate	String	否	开始日期，格式YYYY-MM-DD
edate	String	否	结束日期，格式YYYY-MM-DD
cid	String	否	金融市场分类ID，1代表A股，2代表港股，3代表美股
resultColumnIDs	String	否	结果状态ID，支持多个值逗号分隔，范围为1-6

结果状态说明

1: 盈利
2: 亏损
3: 放弃
4: 待处理（买入或卖出）
5: 已提交量化握手处理等待结果
6: 该指令已在券商买入卖出成功

响应数据结构 (QuantTradeBuyLog)

字段名	类型	描述
ID	Integer	关键字，自递增
AppID	String	归属用户应用ID
SignalID	Integer	量化交易信号ID
FinancialObjectID	Integer	金融标的ID
Code	String	金融标的代码
FinancialName	String	金融标的名称
OperatingMode	Integer	操作模式[1代表真仓模式 2代表模拟仓模式]
TradeDate	String	交易日期
BuyPrice	Float	用户买进价格
BuySum	Integer	用户买入份数
WinPrice	Float	用户止盈价格
StopPrice	Float	用户止损价格
PayMoney	Float	买入金额
ResultColumnID	Integer	最后结果类型（含义见上方说明）
Result	Float	盈利百分点
GolongOrShortsale	Integer	做多还是做空，1代表做多，2代表做空
IsSetStopWin	Integer	是否在交易软件设置止盈，1代表是，0代表否
IsSetStopLoss	Integer	是否在交易软件设置止损，1代表是，0代表否
CurrentPrice	Float	当前标的市场价格
Reason	String	执行操作指令的原因
Enable	Boolean	是否有效，true代表有效，false代表无效
InputTime	DateTime	数据录入的当前时间

请求示例

POST http://www.deephunt.com.cn/api/getbuystock 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&resultColumnIDs=1,2,3

响应示例

json

{
  "code": 1,
  "message": "success",
  "data": [
    {
     "ID": 3,
      "AppID": "hunt6da290c4c4b93847",
      "SignalID": 11776,
      "FinancialObjectID": 10211,
      "Code": "sz300100",
      "FinancialName": "双林股份",
      "OperatingMode": 0,
      "ColumnID": 1,
      "TradeDate": "2026-03-27",
      "BuyPrice": 30.1345,
      "BuySum": 1,
      "WinPrice": 0.00,
      "StopPrice": 29.3733,
      "PayMoney": 0.00,
      "ResultColumnID": 6,
      "Result": 0,
      "GolongOrShortsale": 1,
      "IsSetStopWin": 1,
      "IsSetStopLoss": 1,
      "CurrentPrice": 30.57,
      "Reason": "",
      "Enable": true,
      "InputTime": "2026/3/27 10:30:00"
    }
  ]
}

常见问题FAQ

Q: 为什么接口返回空数据？ A: 可能是因为指定的日期范围内没有符合条件的买入订单，或者参数有误。
Q: 如何只查询盈利的股票？ A: 设置resultColumnIDs为1即可查询盈利的股票。
Q: cid参数如果不传会怎么样？ A: 不传cid参数时，系统会返回所有市场的数据。
Q: 日期格式有什么要求？ A: 日期格式必须是YYYY-MM-DD格式，例如2023-01-01。
Q: 每次最多能返回多少条数据？ A: 每次最多返回100条数据。

2. 获取今天卖出股票接口 `/api/getsellstock`

接口描述

获取用户指定条件下的卖出股票列表，仅返回做空状态且指定结果状态的订单。

请求参数

参数名	类型	必填	描述
appid	String	是	应用ID
appsecret	String	是	应用密钥
sdate	String	否	开始日期，格式YYYY-MM-DD
edate	String	否	结束日期，格式YYYY-MM-DD
cid	String	否	金融市场分类ID，1代表A股，2代表港股，3代表美股
resultColumnIDs	String	否	结果状态ID，支持多个值逗号分隔，范围为1-6，默认为"4,5"

响应数据结构

同 http://www.deephunt.com.cn/api/getbuystock 接口，返回 QuantTradeBuyLog 结构体数组。

请求示例

POST http://www.deephunt.com.cn/api/getsellstock 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&resultColumnIDs=4,5

常见问题FAQ

Q: 为什么默认查询状态为4和5的订单？ A: 因为状态4和5分别代表待处理和已提交量化握手处理等待结果，这些是即将卖出的订单。
Q: 如何查询已完成的卖出订单？ A: 设置resultColumnIDs为6即可查询已完成的卖出订单。
Q: 做空方向如何区分？ A: 在返回数据中GolongOrShortsale字段为2表示做空。
Q: 如果不传resultColumnIDs参数会怎样？ A: 系统会默认使用"4,5"作为查询条件。
Q: 为什么有时查询不到任何数据？ A: 可能是因为当前时间段内没有做空操作的订单。

3. 获取买卖信号接口 `/api/getstocksignal`

接口描述

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

请求参数

参数名	类型	必填	描述
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为做空

响应数据结构 (QuantTradeReCommendSimple)

字段名	类型	描述
ID	Integer	关键字，自递增
AppID	String	归属用户应用ID
FinancialObjectID	Integer	金融标的ID
Code	String	金融代号，用于在某种金融产品的全球唯一识别代码
FinancialName	String	金融产品名称
Fund	Float	总市值
ColumnID	Integer	金融产品类别
GolongOrShortsell	Integer	做多或者做空，1代表做多，2代表做空
Inductry2Code	String	行业2代码
Inductry2Name	String	行业2名称
Inductry4Code	String	行业4代码
Inductry4Name	String	行业4名称
CurrentPrice	Float	当前市场价格
CutPrice	Float	建议止损价格
OperatingMode	Integer	操作模式[1代表真仓模式 2代表模拟仓模式]
ActivityStarGoLong	Integer	活跃度星级
AverageChangePercentageGoLong	Float	最近1年平均做多变动百分比
ActivityStarShortSell	Integer	做空活跃度星级
AverageChangePercentageShortSell	Float	最近一年平均做空变动百分比
Num1BuyingPoint	Float	第一买点价格
Num2BuyingPoint	Float	第二买点价格
Num3BuyingPoint	Float	第三买点价格
Num4BuyingPoint	Float	第四买点价格
TotalChangePercentage	Float	相邻峰峰或者谷谷之间的间距百分点
ChangePercentage	Float	相邻峰谷之间的变动百分点
UpChangePercentage	Float	相对于关联关键点之后的上涨百分点
DownChangePercentage	Float	相对于关联关键点之后的下降百分点
UpChangePercentageint	Integer	相对于关联关键点之后的上涨整数百分点
DownChangePercentageint	Integer	相对于关联关键点之后的下降整数百分点
LastUpdateTime	DateTime	最后一次更新时间
PreKeypoint	Float	上一个关键点价格
PreKeypointDate	String	上一个关键点所在日期
CurrentTrend	Integer	当前标的所属趋势，3代表上涨趋势，4代表自然反弹，5代表下降趋势，6代表自然回档
PeakCountEachYear	Integer	最近1年波峰个数
ValleyCountEachYear	Integer	最近1年波谷个数
Strong	Integer	信号强度，1代表弱，2代表中，3代表强，4代表超强
Hot	Boolean	是否当天热点股票
InflowState	Integer	流入流出标志，1代表流入，0代表流出，2代表不明，3代表止损
InflowCount	Integer	流入或流出时，累计数量
InflowMessage	String	流入或流出时，出现主力净流入信号汇总
CommentColumn	Integer	推荐类型，默认0，1代表AI首推，2代表AI推荐订阅
TradeDate	String	交易日期
BuyPrice	Float	推荐买点价格
CommentResult	Integer	推荐结果，1代表成功，0代表失败，2代表不明
CommentResultDate	String	推荐成功与失败结果的日期
CommentResultChangePercentage	Float	推荐后变动百分点，如推荐后到顶上涨10%，推荐后继续跌了4%
CommentResultTrend	Integer	推荐结果趋势，3代表上涨趋势，4代表自然反弹，5代表下降趋势，6代表自然回档
CommentSuccessfulReasons	String	推荐成功的原因
CommentFailureReasons	String	推荐失败的原因
AvgLongWaitDays	Float	平均做多建仓等待时间天数
AvgLongBuildDays	Float	平均做多建仓时间天数
AvgLongProfitDays	Float	平均做多止盈时间天数
AvgShortWaitDays	Float	平均做空建仓等待时间天数
AvgShortBuildDays	Float	平均做空建仓时间天数
AvgShortProfitDays	Float	平均做空止盈时间天数
IsAI	Boolean	是否为AI推荐
Highlights	String	亮点，用于展示股票的优势，例如："1. 股票价格上涨了10%"，"2. 股票价格下跌了5%"
RecommendationRationale	String	推荐理由，用于展示股票的推荐理由，例如："1. 股票价格上涨了10%，符合市场趋势"，"2. 股票价格下跌了5%，符合市场趋势"
DillStatus	Integer	当前信号所属状态，0为无任何处理，1为买进成功，-1为卖出成功，默认为0
DillTime	DateTime	当前信号最后处理时间，默认为当前时间
Enable	Boolean	是否有效
InputTime	DateTime	数据录入的当前时间

请求示例

POST http://www.deephunt.com.cn/api/getstocksignal 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

2{
  "code": 1,
  "message": "success",
  "data": [
    {
      "ID": 1,
      "AppID": "test_app_id",
      "FinancialObjectID": 10718,
      "Code": "sh601288",
      "FinancialName": "农业银行",
      "Fund": 21804.3789,
      "ColumnID": 1,
      "GolongOrShortsell": 1,
      "Inductry2Code": "4010",
      "Inductry2Name": "银行",
      "Inductry4Code": "40101010",
      "Inductry4Name": "综合性银行",
      "CurrentPrice": 6.7300,
      "CutPrice": 6.3360,
      "OperatingMode": 1,
      "ActivityStarGoLong": 4,
      "AverageChangePercentageGoLong": 45.4600,
      "ActivityStarShortSell": 2,
      "AverageChangePercentageShortSell": -19.1900,
      "Num1BuyingPoint": 6.5920,
      "Num2BuyingPoint": 6.6560,
      "Num3BuyingPoint": 6.7200,
      "Num4BuyingPoint": 6.7840,
      "TotalChangePercentage": -24.4481,
      "ChangePercentage": 5.1562,
      "UpChangePercentage": 5.1562,
      "DownChangePercentage": 0,
      "UpChangePercentageint": 5,
      "DownChangePercentageint": 0,
      "LastUpdateTime": "2026-03-03 15:22:32",
      "PreKeypoint": 0,
      "PreKeypointDate": "",
      "CurrentTrend": 6,
      "PeakCountEachYear": 2,
      "ValleyCountEachYear": 2,
      "Strong": 2,
      "Hot": false,
      "InflowState": 1,
      "InflowCount": 1,
      "InflowMessage": "{"TradeDate":"2026-03-02","Type":"量价齐升 (温和)","Category":"entry","Level":"低机会","Details":"量比1.18倍 | 较前日量增98.76% | 上涨1.25%"}",
      "CommentColumn": 2,
      "TradeDate": "2026-03-03",
      "BuyPrice": 6.5565,
      "CommentResult": 2,
      "CommentResultDate": "",
      "CommentResultChangePercentage": 0.0,
      "CommentResultTrend": 0,
      "CommentSuccessfulReasons": "",
      "CommentFailureReasons": "",
      "AvgLongWaitDays": 3.0000,
      "AvgLongBuildDays": 10.3333,
      "AvgLongProfitDays": 43.6667,
      "AvgShortWaitDays": 1.3333,
      "AvgShortBuildDays": 12.0000,
      "AvgShortProfitDays": 7.0000,
      "IsAI": true,
      "Highlights": "信号强度：中，处于4%~5.99%区间确认，符合主力确认建仓标准，这是我当年操盘时最喜欢的“甜点区间”, 主力行为：净流入，净流入次数1次，配合量价齐升（温和）状态，量比1.18倍且量增98.76%，资金强度与涨幅匹配，避免了“虚量冲高”的陷阱, 股票池：沪深300、上证50，属于大盘权重股，波动小抗跌性强，适合像我这种经历过几轮牛熊的“老江湖”打底仓, 周期形态：自然回档，回档幅度未超30%安全线，符合“-15%至-25%回调区间+中信号强度”的最佳介入技术形态, 标的活跃度：0星级（适合极少投资者），年波峰数量2次，属于低情绪干扰、高趋势持续性标的，比那些日内波动剧烈的热点股靠谱多了",
      "RecommendationRationale": "记住，建仓不是赌博，得像盖房子一样一层层来。这只农业银行现在就是典型的“主力第三次建仓”信号——5.16%的累计涨幅刚好卡在5%~5.99%区间，按照利佛莫尔的金字塔建仓法，现在就该动手买入第3份仓位。我当年在1997年亚洲金融危机后抄底银行股，就是盯着这种“自然回档后量价齐升”的形态，最后赚了3倍。建仓价格6.56是关键，别追高，等回调到这个价位再动手，就像猎豹等猎物进入攻击范围。止损价6.34必须严格执行，收盘价跌破就砍，别犹豫——我1923年那次棉花交易就是因为舍不得止损，最后亏掉了半年利润。政策方面，央行刚释放的流动性支持政策就像给这只票加了“发动机”，结合它45.46%的周期平均涨幅，安全系数很高。适合拿3-6个月，目标看到8块附近，到时候记得分批止盈，别贪——利佛莫尔说过，股市里活着比什么都重要。",
      "DillStatus": 0,
      "DillTime": "2026-03-03 10:30:00"
      "Enable": true,
      "InputTime": "2026-03-03 10:30:00"
    }
  ]
}

常见问题FAQ

Q: 信号推荐的依据是什么？ A: 信号基于利佛莫尔理论和AI算法综合分析得出，考虑了市场趋势、技术指标等多方面因素。
Q: 如何理解Num1BuyingPoint到Num4BuyingPoint？ A: 这些是系统推荐的不同买点价格，数字越小代表风险越低，适合保守投资者。
Q: CutPrice是什么意思？ A: CutPrice是系统建议的止损价格，当股价跌至此价格时建议卖出以控制风险。
Q: ActivityStarGoLong数值越高越好吗？ A: 不一定，高活跃度意味着波动较大，收益和风险都会相应增加。
Q: 如何判断一个信号的质量？ A: 可以关注AverageChangePercentageGoLong、ActivityStarGoLong以及各种买点价格的合理性。

4. 获取股票池接口 `/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)

字段名	类型	描述
ID	Integer	关键字，自递增
AppID	String	归属用户应用ID
FinancialObjectID	Integer	金融标的ID
Code	String	金融代号，用于在某种金融产品的全球唯一识别代码
ColumnID	Integer	金融产品类别,1代表A股，2代表港股，3代表美股
CustomerColumnID	String	金融产品用户自定义类别，可以属于多分类，分类之间使用逗号,分隔，如无，请默认设置为0
Inductry2Code	String	行业2代码
Inductry2Name	String	行业2名称
Inductry4Code	String	行业4代码
Inductry4Name	String	行业4名称
ActivityStarGoLong	Integer	活跃度星级
PeakCountEachYear	Integer	最近1年波峰个数
AverageChangePercentageGoLong	Float	最近1年平均做多变动百分比
ValleyCountEachYear	Integer	最近1年波谷个数
ActivityStarShortSell	Integer	做空活跃度星级
AverageChangePercentageShortSell	Float	最近一年平均做空变动百分比
FinancialName	String	金融产品名称
CurrentPrice	Float	当前市场价格
CurrentVolumn	Float	当前成交量(最后一天)
CurrentTurnoverRate	Float	当前换手率(最后一天)
Num1BuyingPoint	Float	第一买点价格
Num2BuyingPoint	Float	第二买点价格
Num3BuyingPoint	Float	第三买点价格
Num4BuyingPoint	Float	第四买点价格
Own	Boolean	是否持仓
ReboundFinalPrice	Float	上次自然反弹末值
RoolbackFinalPrice	Float	上次自然回档末值
TargetKeyPoint	Float	目标关键点
CurrentTrend	Integer	当前趋势
PrevPeak	Float	上一个周期波峰末值
PrevPeakDate	String	上一个周期波峰发生时间
PrevPeakTrend	Integer	上一个周期波峰技术形态
PrevValley	Float	上一个周期波谷末值
PrevValleyDate	String	上一个周期波谷发生时间
PrevValleyTrend	Integer	上一个波谷技术形态
CurrentPeak	Float	当前阶段波峰
CurrentPeakDate	String	当前周期波峰最后更新时间
CurrentValley	Float	当前阶段波谷
CurrentValleyDate	String	当前波谷最后更新时间
LastUpdateTime	DateTime	最后一次更新时间
ImportKeypointFromDate	String	导入关键点的截止时间
ImportKeypointToDate	String	导入关键点的起始时间
ImportTradeRecordFromDate	String	导入交易日志的起始时间
ImportTradeRecordToDate	String	导入交易日志的截止时间
Hot	Boolean	是否当天热点股票
InflowState	Integer	流入流出标志，1代表流入，0代表流出，2代表不明
InflowCount	Integer	流入或流出时，累计数量
InflowMessage	String	流入或流出时，出现主力净流入信号汇总
AvgLongWaitDays	Float	平均做多建仓等待时间天数
AvgLongBuildDays	Float	平均做多建仓时间天数
AvgLongProfitDays	Float	平均做多止盈时间天数
AvgShortWaitDays	Float	平均做空建仓等待时间天数
AvgShortBuildDays	Float	平均做空建仓时间天数
AvgShortProfitDays	Float	平均做空止盈时间天数
CurLongWaitDays	Float	最后一个周期做多建仓等待时间天数
CurLongBuildDays	Float	最后一个周期做多建仓时间天数
LongBuildFromDate	String	最后一个周期做多建仓开始日期
CurLongProfitDays	Float	最后一个周期做多止盈时间天数
LongProfitFromDate	String	最后一个周期做多止盈开始日期
CurShortWaitDays	Float	最后一个周期做空建仓等待时间天数
CurShortBuildDays	Float	最后一个周期做空建仓时间天数
ShortBuildFromDate	String	最后一个周期做空建仓开始日期
CurShortProfitDays	Float	最后一个周期做空止盈时间天数
ShortProfitFromDate	String	最后一个周期做空止盈开始日期
ChangePercentage	Float	变动百分比
TemporaryDownChangePercentage	Float	做空信号累计变动百分比
TemporaryUpChangePercentage	Float	做多信号累计变动百分比
LastRelateKeyPoint	Float	最后一个关联关键点
TradeDate	String	交易日期
GolongOrShortsale	Integer	做多还是做空，1代表做多，2代表做空
Enable	Boolean	是否有效
InputTime	DateTime	数据录入的当前时间

请求示例

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": "汽车内饰与外饰",
      "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,
      "TemporaryDownChangePercentage": 0,
      "TemporaryUpChangePercentage": 0,
      "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等多个维度进行综合评估。

5. 执行用户量化交易买入交割指令 `/api/executeuserbuytrade`

接口描述

执行指定用户的买单交割操作，用于将待处理的买单状态更新为已买入，并记录真实买入价格。此接口允许用户通过API手动执行买入操作，同步量化交易数据源状态。

请求参数

参数名	类型	必填	描述
appid	String	是	应用ID
appsecret	String	是	应用密钥
id	Integer	是	买单ID
realbuyprice	Float	是	真实买入价格

业务逻辑

验证API访问权限，检查IP白名单、AppID和AppSecret
根据AppID获取用户配置信息
查询指定ID的买单记录，确保属于当前用户且为待处理状态（ResultColumnID为4或5）
将订单状态更新为已买入（ResultColumnID = 6），并记录真实买入价格
更新股票池持仓状态：将持仓中对应标的的持仓状态设为持有（Own = true）
更新信号池对应的信号为已进成功（DillStatus = 1）

响应数据结构

json

{
  "code": 1,
  "message": "买单交割执行成功",
  "data": {
    "trade_executed": true,
    "financial_object_id": 10211,
    "real_buy_price": 30.57,
    "original_buy_price": 30.1345
  }
}

请求示例

POST http://www.deephunt.com.cn/api/executeuserbuytrade Content-Type: application/x-www-form-urlencoded

appid=test_app_id&appsecret=test_app_secret&id=123&realbuyprice=30.50

响应示例

json

{
  "code": 1,
  "message": "买单交割执行成功",
  "data": {
    "trade_executed": true,
    "financial_object_id": 10211,
    "real_buy_price": 30.50,
    "original_buy_price": 30.1345
  }
}

常见问题FAQ

Q: 什么情况下会返回"该买单不是待处理状态，无法执行交割"错误？ A: 当买单的ResultColumnID不为4或5时会出现此错误，表示该买单已处理或未达到可执行状态。
Q: 如何确认买单交割是否成功？ A: 检查响应中的code字段为1，message为"买单交割执行成功"，同时data中的trade_executed为true。
Q: realbuyprice参数有什么限制？ A: realbuyprice必须为有效的浮点数，不能为负数或非数字字符，否则会返回参数格式错误。
Q: 执行交割后，原订单的买入价格会被替换吗？ A: 不会替换，原买入价格会保存在original_buy_price字段中，真实买入价格会更新到BuyPrice字段。
Q: 只有特定状态的买单才能执行交割吗？ A: 是的，只有ResultColumnID为4（待处理）或5（已提交量化握手处理等待结果）状态的买单才能执行交割。

6. 执行用户量化交易卖出交割指令 `/api/executeuserselltrade`

接口描述

执行指定用户的卖单交割操作，用于处理做空操作的卖出订单，核销相关买入订单的盈亏状态，并记录真实卖出价格。此接口允许用户通过API手动执行卖出操作，同步量化交易数据源状态。

请求参数

参数名	类型	必填	描述
appid	String	是	应用ID
appsecret	String	是	应用密钥
id	Integer	是	卖单ID
realsellprice	Float	是	真实卖出价格

业务逻辑

验证API访问权限，检查IP白名单、AppID和AppSecret
根据AppID获取用户配置信息
查询指定ID的卖单记录，确保属于当前用户且为待处理的做空操作（ResultColumnID为4或5且GolongOrShortsale为2）
按时间顺序查询关联的买入订单，使用真实卖出价格计算盈亏
更新买入订单的最终状态（盈利为1，亏损为2），记录盈亏百分点和卖出价格
更新卖单订单状态为完全完结（ResultColumnID = 1）
更新建仓信号为已执行状态（DillStatus = -1）
检查标的是否还有其他活跃买入指令，如无则更新股票池持仓状态为非持仓

响应数据结构

json

{
  "code": 1,
  "message": "卖单交割执行成功",
  "data": {
    "trade_executed": true,
    "financial_object_id": 10211,
    "sold_quantity": 100,
    "real_sell_price": 32.50
  }
}

请求示例

POST http://www.deephunt.com.cn/api/executeuserselltrade Content-Type: application/x-www-form-urlencoded

appid=test_app_id&appsecret=test_app_secret&id=456&realsellprice=32.50

响应示例

json

{
  "code": 1,
  "message": "卖单交割执行成功",
  "data": {
    "trade_executed": true,
    "financial_object_id": 10211,
    "sold_quantity": 100,
    "real_sell_price": 32.50
  }
}

常见问题FAQ

Q: 为什么有时候返回"该记录不是待处理的卖单，无法执行交割"？ A: 可能因为该订单不是做空操作（GolongOrShortsale不为2）或不是待处理状态（ResultColumnID不为4或5）。
Q: 卖单交割是如何处理关联买入订单的？ A: 系统按时间顺序取最早的买入订单，根据真实卖出价格计算盈亏，逐步核销直至卖出数量完全处理。
Q: 盈利和亏损状态是如何判定的？ A: 当真实卖出价格 >= 买入价时为盈利状态（ResultColumnID=1），反之为亏损状态（ResultColumnID=2）。
Q: 如果关联买入订单数量不够核销怎么办？ A: 系统会核销所有可用的买入订单，如有剩余卖出数量未处理，会记录警告信息但不会中断流程。
Q: 卖单执行后对持仓状态有什么影响？ A: 系统会更新建仓信号为已执行状态（DillStatus=-1），如果该标的没有其他活跃买入指令，会将持仓状态设为非持仓（Own=false）。

错误码说明

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

常见错误信息：

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

安全注意事项

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

技术支持

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

猎户座量化交易API接口文档 ​

文档概述 ​

接口通用规范 ​

认证机制 ​

权限校验 ​

通用请求格式 ​

通用响应格式 ​

接口详情 ​

1. 获取今天买入股票接口 /api/getbuystock ​

接口描述 ​

请求参数 ​

结果状态说明 ​

响应数据结构 (QuantTradeBuyLog) ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

2. 获取今天卖出股票接口 /api/getsellstock ​

接口描述 ​

请求参数 ​

响应数据结构 ​

请求示例 ​

常见问题FAQ ​

3. 获取买卖信号接口 /api/getstocksignal ​

接口描述 ​

请求参数 ​

响应数据结构 (QuantTradeReCommendSimple) ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

4. 获取股票池接口 /api/getstockpool ​

接口描述 ​

请求参数 ​

响应数据结构 (QuantTradeFinancialPool) ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

5. 执行用户量化交易买入交割指令 /api/executeuserbuytrade ​

接口描述 ​

请求参数 ​

业务逻辑 ​

响应数据结构 ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

6. 执行用户量化交易卖出交割指令 /api/executeuserselltrade ​

接口描述 ​

请求参数 ​

业务逻辑 ​

响应数据结构 ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

错误码说明 ​

安全注意事项 ​

技术支持 ​

猎户座量化交易API接口文档

文档概述

接口通用规范

认证机制

权限校验

通用请求格式

通用响应格式

接口详情

1. 获取今天买入股票接口 `/api/getbuystock`

接口描述

请求参数

结果状态说明

响应数据结构 (QuantTradeBuyLog)

请求示例

响应示例

常见问题FAQ

2. 获取今天卖出股票接口 `/api/getsellstock`

接口描述

请求参数

响应数据结构

请求示例

常见问题FAQ

3. 获取买卖信号接口 `/api/getstocksignal`

接口描述

请求参数

响应数据结构 (QuantTradeReCommendSimple)

请求示例

响应示例

常见问题FAQ

4. 获取股票池接口 `/api/getstockpool`

接口描述

请求参数

响应数据结构 (QuantTradeFinancialPool)

请求示例

响应示例

常见问题FAQ

5. 执行用户量化交易买入交割指令 `/api/executeuserbuytrade`

接口描述

请求参数

业务逻辑

响应数据结构

请求示例

响应示例

常见问题FAQ

6. 执行用户量化交易卖出交割指令 `/api/executeuserselltrade`

接口描述

请求参数

业务逻辑

响应数据结构

请求示例

响应示例

常见问题FAQ

错误码说明

安全注意事项

技术支持