交易

网格订单详情

GEThttps://openapi.longbridge.com/v1/gridtrading/detail

鉴权

签名方式:每个请求用 App Key / Secret 签名。请求头如下:

名称类型必填说明
Authorizationstring · header必填OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填请求时间戳,单位秒(Unix 时间)。
X-Api-Signaturestring · header必填HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。

查询单个网格订单的完整详情,包括网格规则、分页的成交子订单(grid_sub_orders)以及分页的生命周期历史(grid_order_history)。

>_ CLI
# Rule, sub-orders and history of a grid order
longbridge grid detail 764609681686573056

请求

查询参数

名称类型必填说明
order_idstring必填网格订单 ID,例如:`764609681686573056`
history_idstring可选生命周期历史的分页游标,传入某页最后一条的 `history_id` 以获取更早的记录
limitinteger可选`grid_sub_orders` 与 `grid_order_history` 的分页大小

响应

响应字段

名称类型必填说明
order_idstring必填网格订单 ID
symbolstring必填标的代码,`ticker.region` 格式
stock_namestring必填标的名称
statusstring必填网格订单状态,例如:`Performing` / `Suspended`
grid_statusstring必填网格详细运行状态
suspend_reasonstring必填网格被暂停的原因,运行中时为空
sleeping_reasonstring必填网格休眠的原因,活跃时为空
submitted_base_pricestring必填提交时网格锚定的基准价
current_base_pricestring必填触发后的当前基准价
upper_limit_pricestring必填价格上界
lower_limit_pricestring必填价格下界
trigger_price_typeint32必填触发阈值的计价方式。**枚举值:**, `1` - 价差(绝对值), `2` - 百分比
trigger_spread_upstring必填向上触发价差(当 `trigger_price_type` 为 `1` 时)
trigger_spread_downstring必填向下触发价差(当 `trigger_price_type` 为 `1` 时)
trigger_percent_upstring必填向上触发百分比(当 `trigger_price_type` 为 `2` 时)
trigger_percent_downstring必填向下触发百分比(当 `trigger_price_type` 为 `2` 时)
pullback_percentstring必填回落百分比
pullback_spreadstring必填回落价差
rebound_percentstring必填反弹百分比
rebound_spreadstring必填反弹价差
multiple_triggerboolean必填单个网格档位是否可多次触发
time_in_forceint32必填订单有效期。**枚举值:**, `0` - 当日有效,`1` - GTC, `6` - GTD
trigger_quantitystring必填每次触发的数量
trigger_sell_quantitystring必填卖出方向累计触发数量
trigger_buy_quantitystring必填买入方向累计触发数量
upper_limit_quantitystring必填触及上界时处理的数量
lower_limit_quantitystring必填触及下界时处理的数量
upper_limit_eventint32必填触及上界时的动作。**枚举值:**, `1` - 忽略,`2` - 按最新价平仓
lower_limit_eventint32必填触及下界时的动作。**枚举值:**, `1` - 忽略,`2` - 按最新价平仓
trigger_sell_depthint32必填卖出方向盘口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_up`
trigger_buy_depthint32必填买入方向盘口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_down`
created_atstring必填创建时间,RFC3339 格式
updated_atstring必填最后更新时间,RFC3339 格式
settlement_currencystring必填结算货币,例如:`HKD`
expire_timestring必填过期时间,RFC3339 格式(当 `time_in_force` 为 GTD 时)
gtdstring必填Good-Til-Date,`YYYY-MM-DD` 格式
grid_sub_ordersobject[]可选该网格已成交的子订单
└ idstring必填子订单 ID
└ pricestring必填订单价格
└ order_typestring必填订单类型
└ quantitystring必填订单数量
└ executed_qtystring必填已成交数量
└ actionint32必填买卖方向
└ statusstring必填子订单状态
└ submitted_atstring必填提交时间,RFC3339 格式
└ rthint32必填盘中交易时段标识(`0` / `1` / `2`)
sub_has_moreboolean必填是否还有更多子订单可分页
grid_order_historyobject[]可选生命周期历史记录
└ history_idstring必填历史记录 ID,同时用作分页游标
└ created_atstring必填事件时间,RFC3339 格式
└ suspend_reasonstring必填暂停原因(如适用)
└ reasonstring必填事件的可读描述
history_has_moreboolean必填是否可通过 `history_id` 分页获取更多历史记录
support_shortsellboolean必填是否允许卖空
rthint32必填盘中交易时段标识(`0` / `1` / `2`)
grid_order_type_upstring必填`trigger_sell_depth` 为 `0` 时的卖出方向订单类型。**枚举值:**, `GMO` / `GLO` / `GTG`
grid_order_type_downstring必填`trigger_buy_depth` 为 `0` 时的买入方向订单类型。**枚举值:**, `GMO` / `GLO` / `GTG`

响应 JSON 示例

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "764609681686573056",
    "symbol": "700.HK",
    "stock_name": "TENCENT",
    "status": "Performing",
    "grid_status": "Performing",
    "suspend_reason": "",
    "sleeping_reason": "",
    "submitted_base_price": "300",
    "current_base_price": "300",
    "upper_limit_price": "360",
    "lower_limit_price": "240",
    "trigger_price_type": 2,
    "trigger_spread_up": "",
    "trigger_spread_down": "",
    "trigger_percent_up": "2",
    "trigger_percent_down": "2",
    "pullback_percent": "",
    "pullback_spread": "",
    "rebound_percent": "",
    "rebound_spread": "",
    "multiple_trigger": false,
    "time_in_force": 1,
    "trigger_quantity": "100",
    "trigger_sell_quantity": "0",
    "trigger_buy_quantity": "0",
    "upper_limit_quantity": "200",
    "lower_limit_quantity": "100",
    "upper_limit_event": 1,
    "lower_limit_event": 1,
    "trigger_sell_depth": 0,
    "trigger_buy_depth": 0,
    "created_at": "2024-08-12T10:30:00+08:00",
    "updated_at": "2024-08-12T10:30:00+08:00",
    "settlement_currency": "HKD",
    "expire_time": "",
    "gtd": "",
    "grid_sub_orders": [],
    "sub_has_more": false,
    "grid_order_history": [
      {
        "history_id": "764609681686573100",
        "created_at": "2024-08-12T10:30:00+08:00",
        "status": "Performing",
        "suspend_reason": "",
        "reason": "Grid order started"
      }
    ],
    "history_has_more": false,
    "support_shortsell": false,
    "rth": 0,
    "grid_order_type_up": "GMO",
    "grid_order_type_down": "GMO"
  }
}

错误码

参见错误码文档。