longbridge grid

Manage grid trading strategy orders from the terminal — submit a grid, inspect running grids and their triggers, and suspend, restart, replace, or cancel them.

Basic Usage

# List your grid orders
longbridge grid
| Order ID           | Symbol  | Status     | Base   | Range         | Trigger   | Qty | Triggers | Currency |
|--------------------|---------|------------|--------|---------------|-----------|-----|----------|----------|
| 764609681686573056 | 700.HK  | Performing | 300.00 | 240.00–360.00 | ±2%       | 100 | 3        | HKD      |

Examples

Prepare

# Record the one-time strategy risk-disclosure consent (required before grid trading)
longbridge grid questionnaire
# Show a symbol's grid info: lot size, last price, authorization, currency
longbridge grid info 700.HK

Submit a grid

# Preview a percent-triggered grid on 700.HK (nothing is sent; prints a confirmation code)
longbridge grid submit 700.HK --currency HKD --base-price 300 --upper-price 360 --lower-price 240 \
  --trigger-type percent --trigger-up 2 --trigger-down 2 \
  --quantity 100 --upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc
# Submit it by re-running the identical command with that code
longbridge grid submit 700.HK --currency HKD --base-price 300 --upper-price 360 --lower-price 240 \
  --trigger-type percent --trigger-up 2 --trigger-down 2 \
  --quantity 100 --upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc --execute <CODE>

Replace <CODE> with the confirmation code printed by the preview.

Inspect

# Filter the list by symbol / status
longbridge grid --symbol 700.HK --status Performing
# Query specific grids by ID
longbridge grid --ids 764609681686573056 764609681686573057
# Grid detail: rule, sub-orders, and lifecycle history
longbridge grid detail 764609681686573056
# Trigger history for a grid
longbridge grid triggers 764609681686573056

Manage a running grid

# Modify the grid rule (same flags as submit)
longbridge grid replace 764609681686573056 --base-price 305 --upper-price 360 --lower-price 240 \
  --trigger-type percent --trigger-up 2 --trigger-down 2 \
  --quantity 100 --upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc
# Suspend a running grid (kept, can be restarted)
longbridge grid suspend 764609681686573056
# Restart a suspended grid
longbridge grid restart 764609681686573056
# Cancel a grid (permanent)
longbridge grid cancel 764609681686573056

Options

OptionDescriptionDefault
--symbolFilter the list by security symbol (e.g. 700.HK)—
--statusFilter the list by status, comma-joined (e.g. Performing,Suspended)—
--marketFilter the list by market: US | HK | CN | SG—
--idsQuery specific grid orders by ID—
--currencySettlement currency for submit (e.g. HKD)—
--base-price / --upper-price / --lower-priceGrid base price and upper/lower bounds—
--trigger-typeTrigger interpretation: percent | spread—
--trigger-up / --trigger-downUp/down trigger, read as percent or spread per --trigger-type—
--quantityQuantity per trigger—
--upper-quantity / --lower-quantityQuantity handled at the upper/lower bound—
--order-typeOrder type applied to both sides: GMO | GLO | GTG (--order-type-up / --order-type-down override)—
--tifTime in force: day | gtc | gtd—
--executeConfirmation code printed by the preview of submit, replace, cancel, suspend or restart; without it nothing is sent—

Requirements

OAuth trade permission is required to submit or manage grid orders. Before your first grid order, run longbridge grid questionnaire once to record the strategy risk-disclosure consent (also visible as the authorization flag in longbridge grid info). See the grid trading reference for the full rule and field definitions.

Notes

submit, replace, cancel, suspend and restart are two-step. Run the command without --execute to validate it and print a preview (nothing is sent) ending in a three-digit confirmation code, then re-run the identical command with --execute and that code to execute it. The code is single-use, expires in 10 minutes, and stops working if any field changes. The old --dry-run flag has been removed because previewing is now the default.