猎户座量化交易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...

通用响应格式

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

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

---

接口详情

获取今天买入股票接口 /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

响应示例

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

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

---

错误码说明

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

常见错误信息：

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

安全注意事项

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

技术支持

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