Trade
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Query the paged trigger history of a single grid order — the individual orders the grid has placed each time a trigger fired.
Uses `grid_order_id`, not `order_id`
This endpoint uses grid_order_id, not order_id like the other grid endpoints. Using order_id here will not resolve the grid order.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
grid_order_id | string | Required | Grid order ID, example: `764609681686573056` |
page | integer | Optional | Page number, starting from `1` |
limit | integer | Optional | Page size |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
trigger_orders | object[] | Optional | Triggered orders |
└ id | string | Required | Trigger order ID |
└ status | string | Required | Order status |
└ name | string | Required | Security name |
└ symbol | string | Required | Security symbol, `ticker.region` format |
└ price | string | Required | Order price |
└ quantity | string | Required | Order quantity |
└ executed_price | string | Required | Executed price |
└ executed_qty | string | Required | Executed quantity |
└ submitted_at | string | Required | Submission time, RFC3339 format |
└ action | int32 | Required | Buy/sell direction |
└ order_type | string | Required | Order type |
└ trigger_price | string | Required | Price that triggered this order |
└ msg | string | Required | Additional message |
└ currency | string | Required | Order currency |
└ last_done | string | Required | Last traded price at trigger time |
└ updated_at | string | Required | Last update time, RFC3339 format |
└ time_in_force | int32 | Required | Time in force. **Enum Value:**, `0` - Day, `1` - GTC, `6` - GTD |
└ gtd | string | Required | Good-Til-Date, `YYYY-MM-DD` format |
└ trigger_at | string | Required | Trigger time, RFC3339 format |
└ trigger_status | int32 | Required | Trigger status |
has_more | boolean | Optional | Whether more pages are available |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"trigger_orders": [
{
"id": "764610000000000001",
"status": "Filled",
"name": "TENCENT",
"symbol": "700.HK",
"price": "294",
"quantity": "100",
"executed_price": "294",
"executed_qty": "100",
"submitted_at": "2024-08-12T10:35:00+08:00",
"action": 1,
"order_type": "GMO",
"trigger_price": "294",
"msg": "",
"currency": "HKD",
"last_done": "294",
"updated_at": "2024-08-12T10:35:05+08:00",
"time_in_force": 1,
"gtd": "",
"trigger_at": "2024-08-12T10:35:00+08:00",
"trigger_status": 1
}
],
"has_more": false
}
}Error code
See the Error Codes page for the full list of error codes.