Trade

Grid Trigger History

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

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-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.

>_ CLI
# Trigger history of a grid order
longbridge grid triggers 764609681686573056

Request

Query parameters

NameTypeRequiredDescription
grid_order_idstringRequiredGrid order ID, example: `764609681686573056`
pageintegerOptionalPage number, starting from `1`
limitintegerOptionalPage size

Response

Response properties

NameTypeRequiredDescription
trigger_ordersobject[]OptionalTriggered orders
└ idstringRequiredTrigger order ID
└ statusstringRequiredOrder status
└ namestringRequiredSecurity name
└ symbolstringRequiredSecurity symbol, `ticker.region` format
└ pricestringRequiredOrder price
└ quantitystringRequiredOrder quantity
└ executed_pricestringRequiredExecuted price
└ executed_qtystringRequiredExecuted quantity
└ submitted_atstringRequiredSubmission time, RFC3339 format
└ actionint32RequiredBuy/sell direction
└ order_typestringRequiredOrder type
└ trigger_pricestringRequiredPrice that triggered this order
└ msgstringRequiredAdditional message
└ currencystringRequiredOrder currency
└ last_donestringRequiredLast traded price at trigger time
└ updated_atstringRequiredLast update time, RFC3339 format
└ time_in_forceint32RequiredTime in force. **Enum Value:**, `0` - Day, `1` - GTC, `6` - GTD
└ gtdstringRequiredGood-Til-Date, `YYYY-MM-DD` format
└ trigger_atstringRequiredTrigger time, RFC3339 format
└ trigger_statusint32RequiredTrigger status
has_morebooleanOptionalWhether 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.