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

文档概述

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

接口详情

执行用户量化交易卖出交割指令 `/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接口文档 ​

文档概述 ​

接口详情 ​

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

接口描述 ​

请求参数 ​

业务逻辑 ​

响应数据结构 ​

请求示例 ​

响应示例 ​

常见问题FAQ ​

错误码说明 ​

安全注意事项 ​

技术支持 ​