網格訂單詳情

查詢單個網格訂單的完整詳情，包括網格規則、分頁的成交子訂單（grid_sub_orders）以及分頁的生命週期歷史（grid_order_history）。

CLI

# 查看網格訂單的規則、子訂單與歷史
longbridge grid detail 764609681686573056

SDK Links

Python	longbridge.openapi.GridContext.detail
Rust	longbridge::grid::GridContext#detail
Node.js	GridContext#detail
Java	GridContext.getDetail
C++	longbridge::grid::GridContext::detail

Request

HTTP Method	GET
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

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)

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)

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);
        }
    }
}

use std::sync::Arc;
use longbridge::{
    Config,
    grid::{GridContext, GetGridOrderDetailOptions},
    oauth::OAuthBuilder,
};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    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(())
}

#include <iostream>
#include <longbridge.hpp>

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

{
  "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
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