--- slug: detail sidebar_position: 5 title: 網格訂單詳情 sidebar_label: '訂單詳情' language_tabs: false toc_footers: [] includes: [] search: true highlight_theme: '' headingLevel: 2 --- 查詢單個網格訂單的完整詳情，包括網格規則、分頁的成交子訂單（`grid_sub_orders`）以及分頁的生命週期歷史（`grid_order_history`）。 # 查看網格訂單的規則、子訂單與歷史 longbridge grid detail 764609681686573056 ## Request
HTTP MethodGET
HTTP URL/v1/gridtrading/detail
### Parameters > Content-Type: application/json; charset=utf-8 | Name | Type | Required | Description | | ---------- | ------ | -------- | ------------------------------------------------------------------- | | order_id | string | YES | 網格訂單 ID，例如：`764609681686573056` | | history_id | string | NO | 生命週期歷史的分頁游標，傳入某頁最後一條的 `history_id` 以獲取更早的記錄 | | limit | int32 | NO | `grid_sub_orders` 與 `grid_order_history` 的分頁大小 | ### Request Example ```python from longbridge.openapi import GridContext, Config, OAuthBuilder oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url)) config = Config.from_oauth(oauth) # 網格 REST 調用通過獨立的 GridContext ctx = GridContext(config) resp = ctx.detail("764609681686573056") print(resp) ``` ```javascript const { Config, GridContext, OAuth } = require('longbridge') async function main() { const oauth = await OAuth.build('your-client-id', (_, url) => { console.log('Open this URL to authorize: ' + url) }) const config = Config.fromOAuth(oauth) const ctx = GridContext.new(config) const resp = await ctx.detail({ orderId: '764609681686573056' }) console.log(resp) } main().catch(console.error) ``` ```java import com.longbridge.*; import com.longbridge.grid.*; class Main { public static void main(String[] args) throws Exception { try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get(); Config config = Config.fromOAuth(oauth); GridContext ctx = GridContext.create(config)) { GridOrderDetail resp = ctx.detail(new GetGridOrderDetailOptions("764609681686573056")).get(); System.out.println(resp); } } } ``` ```rust use std::sync::Arc; use longbridge::{ Config, grid::{GridContext, GetGridOrderDetailOptions}, oauth::OAuthBuilder, }; #[tokio::main] async fn main() -> Result<(), Box> { let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open this URL to authorize: {url}")).await?; let config = Arc::new(Config::from_oauth(oauth)); let ctx = GridContext::new(config); let resp = ctx.detail(GetGridOrderDetailOptions::new("764609681686573056")).await?; println!("{:?}", resp); Ok(()) } ``` ```cpp #include #include using namespace longbridge; using namespace longbridge::grid; static void run(const OAuth& oauth) { Config config = Config::from_oauth(oauth); GridContext ctx = GridContext::create(config); GetGridOrderDetailOptions opts{ "764609681686573056" }; ctx.detail(opts, [](auto res) { if (!res) { std::cout << "failed" << std::endl; return; } std::cout << "order_id: " << res->order_id << std::endl; }); } int main(int argc, char const* argv[]) { const std::string client_id = "your-client-id"; OAuthBuilder(client_id).build( [](const std::string& url) { std::cout << "Open this URL to authorize: " << url << std::endl; }, [](auto res) { if (!res) { std::cout << "authorization failed" << std::endl; return; } run(*res); }); std::cin.get(); return 0; } ``` ## Response ### Response Headers - Content-Type: application/json ### Response Example ```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" } } ``` ### Response Status | Status | Description | Schema | | ------ | ------------------------------ | ------ | | 200 | 網格訂單詳情返回成功。 | [grid_order_detail_rsp](#schemagrid_order_detail_rsp) | | 400 | 請求被拒絕，請求參數錯誤。 | None | ## Schemas ### grid_order_detail_rsp | Name | Type | Required | Description | | --------------------- | -------- | -------- | ------------------------------------------------------------------------------------------- | | order_id | string | true | 網格訂單 ID | | symbol | string | true | 標的代碼，`ticker.region` 格式 | | stock_name | string | true | 標的名稱 | | status | string | true | 網格訂單狀態，例如：`Performing` / `Suspended` | | grid_status | string | true | 網格詳細運行狀態 | | suspend_reason | string | true | 網格被暫停的原因，運行中時為空 | | sleeping_reason | string | true | 網格休眠的原因，活躍時為空 | | submitted_base_price | string | true | 提交時網格錨定的基準價 | | current_base_price | string | true | 觸發後的當前基準價 | | upper_limit_price | string | true | 價格上界 | | lower_limit_price | string | true | 價格下界 | | trigger_price_type | int32 | true | 觸發閾值的計價方式

**枚舉值：**
`1` - 價差（絕對值）
`2` - 百分比 | | trigger_spread_up | string | true | 向上觸發價差（當 `trigger_price_type` 為 `1` 時） | | trigger_spread_down | string | true | 向下觸發價差（當 `trigger_price_type` 為 `1` 時） | | trigger_percent_up | string | true | 向上觸發百分比（當 `trigger_price_type` 為 `2` 時） | | trigger_percent_down | string | true | 向下觸發百分比（當 `trigger_price_type` 為 `2` 時） | | pullback_percent | string | true | 回落百分比 | | pullback_spread | string | true | 回落價差 | | rebound_percent | string | true | 反彈百分比 | | rebound_spread | string | true | 反彈價差 | | multiple_trigger | boolean | true | 單個網格檔位是否可多次觸發 | | time_in_force | int32 | true | 訂單有效期

**枚舉值：**
`0` - 當日有效
`1` - GTC
`6` - GTD | | trigger_quantity | string | true | 每次觸發的數量 | | trigger_sell_quantity | string | true | 賣出方向累計觸發數量 | | trigger_buy_quantity | string | true | 買入方向累計觸發數量 | | upper_limit_quantity | string | true | 觸及上界時處理的數量 | | lower_limit_quantity | string | true | 觸及下界時處理的數量 | | upper_limit_event | int32 | true | 觸及上界時的動作

**枚舉值：**
`1` - 忽略
`2` - 按最新價平倉 | | lower_limit_event | int32 | true | 觸及下界時的動作

**枚舉值：**
`1` - 忽略
`2` - 按最新價平倉 | | trigger_sell_depth | int32 | true | 賣出方向盤口深度（-5 ~ 5）。`0` = 使用 `grid_order_type_up` | | trigger_buy_depth | int32 | true | 買入方向盤口深度（-5 ~ 5）。`0` = 使用 `grid_order_type_down` | | created_at | string | true | 創建時間，RFC3339 格式 | | updated_at | string | true | 最後更新時間，RFC3339 格式 | | settlement_currency | string | true | 結算貨幣，例如：`HKD` | | expire_time | string | true | 過期時間，RFC3339 格式（當 `time_in_force` 為 GTD 時） | | gtd | string | true | Good-Til-Date，`YYYY-MM-DD` 格式 | | grid_sub_orders | object[] | false | 該網格已成交的子訂單 | | ∟ id | string | true | 子訂單 ID | | ∟ price | string | true | 訂單價格 | | ∟ order_type | string | true | 訂單類型 | | ∟ quantity | string | true | 訂單數量 | | ∟ executed_qty | string | true | 已成交數量 | | ∟ action | int32 | true | 買賣方向 | | ∟ status | string | true | 子訂單狀態 | | ∟ submitted_at | string | true | 提交時間，RFC3339 格式 | | ∟ rth | int32 | true | 盤中交易時段標識（`0` / `1` / `2`） | | sub_has_more | boolean | true | 是否還有更多子訂單可分頁 | | grid_order_history | object[] | false | 生命週期歷史記錄 | | ∟ history_id | string | true | 歷史記錄 ID，同時用作分頁游標 | | ∟ created_at | string | true | 事件時間，RFC3339 格式 | | ∟ status | string | true | 事件後的網格狀態 | | ∟ suspend_reason | string | true | 暫停原因（如適用） | | ∟ reason | string | true | 事件的可讀描述 | | history_has_more | boolean | true | 是否可通過 `history_id` 分頁獲取更多歷史記錄 | | support_shortsell | boolean | true | 是否允許賣空 | | rth | int32 | true | 盤中交易時段標識（`0` / `1` / `2`） | | grid_order_type_up | string | true | `trigger_sell_depth` 為 `0` 時的賣出方向訂單類型

**枚舉值：**
`GMO` / `GLO` / `GTG` | | grid_order_type_down | string | true | `trigger_buy_depth` 為 `0` 時的買入方向訂單類型

**枚舉值：**
`GMO` / `GLO` / `GTG` |