交易
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
查询单个网格订单的完整详情,包括网格规则、分页的成交子订单(grid_sub_orders)以及分页的生命周期历史(grid_order_history)。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
order_id | string | 必填 | 网格订单 ID,例如:`764609681686573056` |
history_id | string | 可选 | 生命周期历史的分页游标,传入某页最后一条的 `history_id` 以获取更早的记录 |
limit | integer | 可选 | `grid_sub_orders` 与 `grid_order_history` 的分页大小 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
order_id | string | 必填 | 网格订单 ID |
symbol | string | 必填 | 标的代码,`ticker.region` 格式 |
stock_name | string | 必填 | 标的名称 |
status | string | 必填 | 网格订单状态,例如:`Performing` / `Suspended` |
grid_status | string | 必填 | 网格详细运行状态 |
suspend_reason | string | 必填 | 网格被暂停的原因,运行中时为空 |
sleeping_reason | string | 必填 | 网格休眠的原因,活跃时为空 |
submitted_base_price | string | 必填 | 提交时网格锚定的基准价 |
current_base_price | string | 必填 | 触发后的当前基准价 |
upper_limit_price | string | 必填 | 价格上界 |
lower_limit_price | string | 必填 | 价格下界 |
trigger_price_type | int32 | 必填 | 触发阈值的计价方式。**枚举值:**, `1` - 价差(绝对值), `2` - 百分比 |
trigger_spread_up | string | 必填 | 向上触发价差(当 `trigger_price_type` 为 `1` 时) |
trigger_spread_down | string | 必填 | 向下触发价差(当 `trigger_price_type` 为 `1` 时) |
trigger_percent_up | string | 必填 | 向上触发百分比(当 `trigger_price_type` 为 `2` 时) |
trigger_percent_down | string | 必填 | 向下触发百分比(当 `trigger_price_type` 为 `2` 时) |
pullback_percent | string | 必填 | 回落百分比 |
pullback_spread | string | 必填 | 回落价差 |
rebound_percent | string | 必填 | 反弹百分比 |
rebound_spread | string | 必填 | 反弹价差 |
multiple_trigger | boolean | 必填 | 单个网格档位是否可多次触发 |
time_in_force | int32 | 必填 | 订单有效期。**枚举值:**, `0` - 当日有效,`1` - GTC, `6` - GTD |
trigger_quantity | string | 必填 | 每次触发的数量 |
trigger_sell_quantity | string | 必填 | 卖出方向累计触发数量 |
trigger_buy_quantity | string | 必填 | 买入方向累计触发数量 |
upper_limit_quantity | string | 必填 | 触及上界时处理的数量 |
lower_limit_quantity | string | 必填 | 触及下界时处理的数量 |
upper_limit_event | int32 | 必填 | 触及上界时的动作。**枚举值:**, `1` - 忽略,`2` - 按最新价平仓 |
lower_limit_event | int32 | 必填 | 触及下界时的动作。**枚举值:**, `1` - 忽略,`2` - 按最新价平仓 |
trigger_sell_depth | int32 | 必填 | 卖出方向盘口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_up` |
trigger_buy_depth | int32 | 必填 | 买入方向盘口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_down` |
created_at | string | 必填 | 创建时间,RFC3339 格式 |
updated_at | string | 必填 | 最后更新时间,RFC3339 格式 |
settlement_currency | string | 必填 | 结算货币,例如:`HKD` |
expire_time | string | 必填 | 过期时间,RFC3339 格式(当 `time_in_force` 为 GTD 时) |
gtd | string | 必填 | Good-Til-Date,`YYYY-MM-DD` 格式 |
grid_sub_orders | object[] | 可选 | 该网格已成交的子订单 |
└ id | string | 必填 | 子订单 ID |
└ price | string | 必填 | 订单价格 |
└ order_type | string | 必填 | 订单类型 |
└ quantity | string | 必填 | 订单数量 |
└ executed_qty | string | 必填 | 已成交数量 |
└ action | int32 | 必填 | 买卖方向 |
└ status | string | 必填 | 子订单状态 |
└ submitted_at | string | 必填 | 提交时间,RFC3339 格式 |
└ rth | int32 | 必填 | 盘中交易时段标识(`0` / `1` / `2`) |
sub_has_more | boolean | 必填 | 是否还有更多子订单可分页 |
grid_order_history | object[] | 可选 | 生命周期历史记录 |
└ history_id | string | 必填 | 历史记录 ID,同时用作分页游标 |
└ created_at | string | 必填 | 事件时间,RFC3339 格式 |
└ suspend_reason | string | 必填 | 暂停原因(如适用) |
└ reason | string | 必填 | 事件的可读描述 |
history_has_more | boolean | 必填 | 是否可通过 `history_id` 分页获取更多历史记录 |
support_shortsell | boolean | 必填 | 是否允许卖空 |
rth | int32 | 必填 | 盘中交易时段标识(`0` / `1` / `2`) |
grid_order_type_up | string | 必填 | `trigger_sell_depth` 为 `0` 时的卖出方向订单类型。**枚举值:**, `GMO` / `GLO` / `GTG` |
grid_order_type_down | string | 必填 | `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"
}
}错误码
参见错误码文档。