# Get Order Detail
Retrieves the order details for a specific trade via the order ID.
# OpenAPI definition
```json
{
"info": {
"title": "Webull Open API Reference",
"description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
"contact": {
"name": "",
"url": "",
"email": ""
},
"version": "2.0",
"x-logo": {
"url": "static/png/logo.png"
}
},
"servers": [
{
"url": "https://broker-api.sandbox.webull.hk"
}
],
"path": "/broker/orders/get",
"method": "get",
"tags": [
"Order Query"
],
"description": "Retrieves the order details for a specific trade via the order ID.",
"operationId": "brokerOrderDetail",
"parameters": [
{
"name": "account_id",
"in": "query",
"description": "Account identifier.",
"required": true,
"schema": {
"type": "String"
},
"example": "LOJOQITOD49R6G9BPQM489CISA"
},
{
"name": "client_order_id",
"in": "query",
"description": "Unique client-defined identifier for the order.
Maximum length is 32 characters and must be unique per user/account.
Used to track or reference the order when interacting with the system.",
"required": true,
"schema": {
"type": "String"
},
"example": "0KGOHL4PR2SLC0DKIND4TI0002"
},
{
"name": "x-app-key",
"in": "header",
"description": "A unique identifier issued to a developer for accessing an application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-app-secret",
"in": "header",
"description": "A unique key issued to developers to access the application's API.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-timestamp",
"in": "header",
"description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-signature-version",
"in": "header",
"description": "Signature algorithm version, default is 1.0.",
"required": true,
"schema": {
"type": "string",
"default": "1.0"
},
"examples": {
"1.0": {
"value": "1.0"
}
}
},
{
"name": "x-signature-algorithm",
"in": "header",
"description": "Signature algorithm, default is HMAC-SHA1.",
"required": true,
"schema": {
"type": "string",
"default": "HMAC-SHA1"
},
"examples": {
"HMAC-SHA1": {
"value": "HMAC-SHA1"
}
}
},
{
"name": "x-signature-nonce",
"in": "header",
"description": "Signature unique random number.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-version",
"in": "header",
"description": "API interface version. Supported values: `v2`, `v3`.",
"required": true,
"schema": {
"type": "string",
"default": "v3"
},
"examples": {
"v3": {
"value": "v3"
}
}
},
{
"name": "x-signature",
"in": "header",
"description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Request successful",
"content": {
"application/json": {
"schema": {
"required": [
"client_order_id",
"orders"
],
"type": "object",
"properties": {
"client_order_id": {
"type": "string",
"description": "Client-defined order identifier. Returned in the response for simple orders.
Represents the unique order ID assigned by the user when placing the order.",
"example": "THI82O5JB7MQ2K76LL5FSDS2CB"
},
"combo_type": {
"type": "string",
"description": "Specifies the type of order combination. For details, please refer to [Combo Order](/apis/docs/trade-api/stock/#combo-orders-us-only).
• NORMAL: A standard single order.
• MASTER: A primary order that triggers a take-profit or stop-loss order upon execution
• STOP_PROFIT: A take-profit order
• STOP_LOSS: A stop-loss order
• OTO: An order that triggers another order upon execution (One-Triggers-the-Other)
• OCO: A pair of orders where the execution of one cancels the other (One-Cancels-the-Other)
• OTOCO: An order that triggers an OCO order set upon execution (One-Triggers-One-Cancels-the-Other) ",
"example": "NORMAL",
"enum": [
"NORMAL",
"MASTER",
"STOP_PROFIT",
"STOP_LOSS",
"OTO",
"OCO",
"OTOCO"
]
},
"orders": {
"type": "array",
"description": "Order Details",
"items": {
"required": [
"client_order_id",
"order_id",
"order_type",
"place_time_at",
"side",
"status",
"symbol",
"time_in_force",
"total_quantity"
],
"type": "object",
"properties": {
"client_order_id": {
"type": "string",
"description": "Client-defined order identifier. Returned in the response for simple orders.
Represents the unique order ID assigned by the user when placing the order.",
"example": "THI82O5JB7MQ2K76LL5FSDS2CB"
},
"order_id": {
"type": "string",
"description": "System-generated order identifier. Returned in the response for simple orders.
Represents the unique Webull order ID assigned by the system.",
"example": "0352U72LQI6DT0KF41GK000000"
},
"symbol": {
"type": "string",
"description": "Trading symbol of the financial instrument.Represents the unique identifier of the security in the specified market (e.g., ticker symbol for equities or option symbol code for derivatives).",
"example": "AAPL"
},
"side": {
"type": "string",
"description": "The order side indicating the intended trading direction of the transaction. The meaning of side may vary depending on the instrument_type and account type (e.g., margin vs. cash).",
"example": "BUY",
"enum": [
"BUY",
"SELL",
"SHORT"
]
},
"status": {
"type": "string",
"description": "• PENDING: Indicates that the order has been submitted to the exchange and is awaiting completion
• SUBMITTED: Indicates that the order has been submitted to the exchange and is awaiting completion
• CANCELLED: Indicates that the order has been successfully cancelled
• FILLED: Indicates that the order has been fully executed
• FAILED: Indicates a failed order, such as REJECTED
• PARTIAL_FILLED: Refers to the portion of the order that has been completed, but not all of it has been completed",
"example": "SUBMITTED",
"enum": [
"PENDING",
"SUBMITTED",
"CANCELLED",
"FILLED",
"FAILED",
"PARTIAL_FILLED"
]
},
"order_type": {
"type": "string",
"description": "Specifies the type of order to be placed. Determines how the order will be executed in the market.
Available order types depend on the market and instrument type.
Options trading Only LIMIT,STOP_LOSS,STOP_LOSS_LIMIT are supported.
U.S. Stock
• LIMIT: Limit Order
• MARKET: Market Order
• STOP_LOSS: Stop Order
• STOP_LOSS_LIMIT: Stop Limit Order
• MARKET_ON_OPEN: Opening market order
• MARKET_ON_CLOSE: Closing market order
Hong Kong Stock
• ENHANCED_LIMIT: Enhanced Limit Order
• AT_AUCTION: At-auction order
• AT_AUCTION_LIMIT: At-auction limit order
• STOP_LOSS: Stop Order
• STOP_LOSS_LIMIT: Stop Limit Order
• TRAILING_STOP_LOSS: Trailing Stop Order
• TRAILING_STOP_LOSS_LIMIT: Trailing Stop Limit Order
• TOUCH_MKT: Touch Market Order
• TOUCH_LMT: Touch Limit Order
• MARKET: Market Order
• ODD_LOT_LIMIT: Odd Lot Limit Order
• MARKET_ON_OPEN: Opening market order
• MARKET_ON_CLOSE: Closing market order
HK Options
• LIMIT: Limit Order
• MARKET: Market Order
• STOP_LOSS: Stop Order
• STOP_LOSS_LIMIT: Stop Limit Order
China Connect
• LIMIT: Limit Order
",
"example": "MARKET",
"enum": [
"LIMIT",
"MARKET",
"STOP_LOSS",
"STOP_LOSS_LIMIT",
"ENHANCED_LIMIT",
"AT_AUCTION",
"AT_AUCTION_LIMIT",
"MARKET_ON_OPEN",
"MARKET_ON_CLOSE",
"TRAILING_STOP_LOSS",
"TRAILING_STOP_LOSS_LIMIT",
"TOUCH_MKT",
"TOUCH_LMT",
"ODD_LOT_LIMIT"
]
},
"instrument_type": {
"type": "string",
"description": "Type of financial instrument associated with the request.",
"example": "EQUITY",
"enum": [
"EQUITY",
"OPTION"
]
},
"support_trading_session": {
"type": "string",
"description": "Specifies the trading session for the order. Applicable to U.S. stock market orders only.
Deprecated values:
• Y: [Deprecated]Include extended trading hours.
• N: [Deprecated]Only support regular trading hours.
Active values:
• NIGHT: Only supports night trading.
• ALL: Include extended trading hours.
• CORE: Only support regular trading hours.
• ALL_DAY: Included Overnight Hours, 8:00 p.m.ET - 8:00 p.m.ET(the next day)",
"example": "CORE",
"enum": [
"Y",
"N",
"NIGHT",
"ALL",
"CORE",
"ALL_DAY"
]
},
"time_in_force": {
"type": "string",
"description": "Specifies the duration for which the order remains active in the market (Time-In-Force).
• DAY: The order is valid only for the current trading day and expires at the end of the day.
• GTC: Good-Till-Canceled, the order remains active until it is executed, explicitly canceled, or reaches the maximum allowed duration (typically 90 days).",
"example": "DAY",
"enum": [
"DAY",
"GTC"
]
},
"total_quantity": {
"type": "string",
"description": "Total order quantity. Represents the total number of units submitted for this order.",
"example": "1"
},
"filled_quantity": {
"type": "string",
"description": "Quantity that has been executed. Represents the number of units that have been filled so far.",
"example": "1"
},
"filled_price": {
"type": "string",
"description": "Average transaction price of the filled quantity. If the order has not been executed yet, this may be zero or null.",
"example": "11.0"
},
"limit_price": {
"type": "string",
"description": "Limit price of the order. Required when order_type is LIMIT, STOP_LOSS_LIMIT, ENHANCED_LIMIT, or AT_AUCTION_LIMIT or TOUCH_LMT.
Specifies the maximum (for buy) or minimum (for sell) price at which the order can be executed.",
"example": "11.0"
},
"stop_price": {
"type": "string",
"description": "Stop price of the order. Required when order_type is STOP_LOSS, STOP_LOSS_LIMIT, TOUCH_MKT or TOUCH_LMT.
Specifies the trigger price at which the stop order becomes active.",
"example": "11.0"
},
"trailing_type": {
"type": "string",
"description": "When market continues to fall, the stop price to buy follows, or trails, the lowest price of a stock by a trail that you set. Required when order_type is TRAILING_STOP_LOSS or TRAILING_STOP_LOSS_LIMIT.
• AMOUNT: By amount.
• PERCENTAGE: By percentage.",
"example": "AMOUNT",
"enum": [
"AMOUNT",
"PERCENTAGE"
]
},
"trailing_stop_step": {
"type": "string",
"description": "Trailing Stop Spread. If the tracking type is percentage, the tracking spread can not exceed 1,0.01 means 1%. Required when order_type is TRAILING_STOP_LOSS or TRAILING_STOP_LOSS_LIMIT.",
"example": "1"
},
"trailing_limit_price_offset": {
"type": "string",
"description": "The offset amount between the triggered stop price and the submitted limit price for a trailing stop-limit order. Required when order_type is TRAILING_STOP_LOSS_LIMIT.
When triggered, the limit order price is calculated as:
• Buy: limit price = stop price + trailing_limit_price_offset
• Sell: limit price = stop price − trailing_limit_price_offset
If the calculated limit price does not align with the instrument's tick size, it will be rounded to the nearest valid tick: rounded up for buy orders, rounded down for sell orders.",
"example": "11.0"
},
"trigger_price_type": {
"type": "string",
"description": "Trigger price type of the order
• PRICE: Latest transaction price.
• PRICE_BID: Buy at one price.
• PRICE_ASK: Sell at one price. ",
"example": "PRICE",
"enum": [
"PRICE",
"PRICE_BID",
"PRICE_ASK"
]
},
"place_time": {
"type": "string",
"description": "Order placement time in milliseconds since Unix epoch.",
"example": "1726745361658",
"deprecated": true
},
"place_time_at": {
"type": "string",
"description": "Order placement time in ISO8601 format (UTC). Format: YYYY-MM-DDThh:mm:ssZ",
"example": "2025-11-11T05:44:35.385Z"
},
"filled_time": {
"type": "string",
"description": "Time of the last executed trade in milliseconds since Unix epoch.",
"example": "1726745361871",
"deprecated": true
},
"filled_time_at": {
"type": "string",
"description": "Time of the last executed trade in ISO8601 format (UTC). Format: YYYY-MM-DDThh:mm:ssZ",
"example": "2025-11-11T05:44:35.385Z"
},
"commission": {
"type": "object",
"properties": {
"actual_commission": {
"type": "string",
"description": "Actual commission collected",
"example": "1.0"
},
"receivable_commission": {
"type": "string",
"description": "Receivable commission",
"example": "1.0"
}
},
"description": "Commission breakdown",
"title": "CommonCommissionResultVO"
},
"fees": {
"type": "array",
"description": "Fee breakdown",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Fee type",
"example": "FINRA_CAT_REGULATORY_FEE"
},
"actual_value": {
"type": "string",
"description": "Actual fee collected",
"example": "1.0"
},
"receivable_value": {
"type": "string",
"description": "Receivable fee",
"example": "1.0"
}
},
"description": "Fee breakdown",
"title": "CommonFeeResultVO"
}
},
"legs": {
"type": "array",
"description": "Leg detail",
"items": {
"required": [
"quantity",
"side",
"symbol"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the leg.",
"example": "G2JAJPOR4KUA0F5I9LONH8J83A"
},
"symbol": {
"type": "string",
"description": "Trading symbol of the financial instrument.Represents the unique identifier of the security in the specified market (e.g., ticker symbol for equities or option symbol code for derivatives).",
"example": "AAPL"
},
"side": {
"type": "string",
"description": "The order side indicating the intended trading direction of the transaction. The meaning of side may vary depending on the instrument_type and account type (e.g., margin vs. cash).",
"example": "BUY",
"enum": [
"BUY",
"SELL",
"SHORT"
]
},
"quantity": {
"type": "string",
"description": "Quantity of the order. Specifies the number of shares or units to transact.
For US stocks, fractional quantities are allowed and can include decimals.",
"example": "1"
},
"option_type": {
"type": "string",
"description": "Type of the option.
• CALL: Right to buy the underlying asset.
• PUT: Right to sell the underlying asset.",
"example": "CALL",
"enum": [
"CALL",
"PUT"
]
},
"option_category": {
"type": "string",
"description": "Category of the option, indicating its exercise style.
Possible values:
• AMERICAN: Can be exercised any time before expiration.
• EUROPEAN: Can only be exercised at expiration. ",
"example": "AMERICAN",
"enum": [
"AMERICAN",
"EUROPEAN"
]
},
"option_strategy": {
"type": "string",
"description": "Type of options strategy
• SINGLE: Single-leg options order
• COVERED_STOCK: Covered call (stock + sell CALL)
• STRADDLE: Same strike, same expiry CALL + PUT
• STRANGLE: Different strike, same expiry CALL + PUT
• VERTICAL: Same expiry, different strike, same type (Bull/Bear Spread)
• CALENDAR: Same strike, different expiry, same type
• DIAGONAL: Different strike, different expiry, same type
• COLLAR_WITH_STOCK: Stock + buy PUT + sell CALL
• BUTTERFLY: Buy low + sell 2 mid + buy high (same type)
• CONDOR: Four different strikes, same type
• IRON_BUTTERFLY: Buy low PUT + sell mid PUT + sell mid CALL + buy high CALL
• IRON_CONDOR: Buy low PUT + sell mid-low PUT + sell mid-high CALL + buy high CALL
• RATIO: Same expiry, same option type, unequal leg quantities (e.g. buy 1 low-strike CALL + sell 2 high-strike CALLs)",
"example": "SINGLE",
"enum": [
"SINGLE",
"COVERED_STOCK",
"STRADDLE",
"STRANGLE",
"VERTICAL",
"CALENDAR",
"DIAGONAL",
"COLLAR_WITH_STOCK",
"BUTTERFLY",
"CONDOR",
"IRON_BUTTERFLY",
"IRON_CONDOR",
"RATIO"
]
},
"strike_price": {
"type": "string",
"description": "Exercise price (strike price) of the option.
Specifies the price at which the underlying asset can be bought (CALL) or sold (PUT) upon exercise.",
"example": "190.0"
},
"option_contract_multiplier": {
"type": "string",
"description": "The number of shares corresponding to each option contract",
"example": "100"
},
"option_contract_deliverable": {
"type": "string",
"description": "The number of shares required to exercise each contract",
"example": "100"
},
"option_expire_date": {
"type": "string",
"description": "Expiration date of the option.
Format: yyyy-MM-dd. After this date, the option will no longer be valid.",
"example": "2025-11-21"
}
},
"description": "Leg detail",
"title": "BrokerOrderListLeg"
}
}
},
"description": "Order Details",
"title": "BrokerOrderDetailItem"
}
}
},
"title": "BrokerOrderDetailResult"
},
"examples": {
"Example": {
"description": "Example",
"value": {
"client_order_id": "41099381429646009294",
"orders": [
{
"symbol": "AAPL",
"side": "BUY",
"status": "FILLED",
"legs": [
{
"id": "037RUBB7QO8F60KHJOIO000000",
"quantity": "100.000000",
"side": "BUY",
"symbol": "AAPL"
},
{
"id": "037RUBB7QO8F60KHJOIO000001",
"quantity": "1.000000",
"side": "SELL",
"symbol": "AAPL",
"option_type": "CALL",
"option_expire_date": "2026-09-18",
"strike_price": "315",
"option_category": "AMERICAN",
"option_contract_multiplier": "100",
"option_contract_deliverable": "100"
}
],
"client_order_id": "41099381429646009294",
"order_type": "MARKET",
"instrument_type": "OPTION",
"order_id": "037RUBB7HG8F60KHJOIO000000",
"support_trading_session": "CORE",
"total_quantity": "1.000000",
"filled_quantity": "1.000000",
"place_time": "1784531308312",
"option_strategy": "COVERED_STOCK",
"place_time_at": "2026-07-20T07:08:28.312Z",
"filled_time": "1784531309477",
"filled_time_at": "2026-07-20T07:08:29.477Z",
"filled_price": "304.90",
"time_in_force": "DAY"
}
]
}
}
}
}
}
},
"401": {
"description": "Unauthorized: Authentication required",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "UNAUTHORIZED"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Insufficient permission"
}
}
}
}
}
},
"417": {
"description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "INVALID_PARAMETER"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Parameter error, phone"
}
}
}
}
}
},
"500": {
"description": "Internal Server Error.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "Internal logic error code",
"example": "SYSTEM_ERROR"
},
"message": {
"type": "string",
"description": "Error message",
"example": "Internal Server Error"
}
}
}
}
}
}
},
"postman": {
"name": "Get Order Detail",
"description": {
"content": "Retrieves the order details for a specific trade via the order ID.",
"type": "text/plain"
},
"url": {
"path": [
"broker",
"orders",
"get"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"description": {
"content": "(Required) Account identifier.",
"type": "text/plain"
},
"key": "account_id",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Unique client-defined identifier for the order.
Maximum length is 32 characters and must be unique per user/account.
Used to track or reference the order when interacting with the system.",
"type": "text/plain"
},
"key": "client_order_id",
"value": ""
}
],
"variable": []
},
"header": [
{
"disabled": false,
"description": {
"content": "(Required) A unique identifier issued to a developer for accessing an application's API.",
"type": "text/plain"
},
"key": "x-app-key",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A unique key issued to developers to access the application's API.",
"type": "text/plain"
},
"key": "x-app-secret",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
"type": "text/plain"
},
"key": "x-timestamp",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm version, default is 1.0.",
"type": "text/plain"
},
"key": "x-signature-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature algorithm, default is HMAC-SHA1.",
"type": "text/plain"
},
"key": "x-signature-algorithm",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) Signature unique random number.",
"type": "text/plain"
},
"key": "x-signature-nonce",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) API interface version. Supported values: `v2`, `v3`.",
"type": "text/plain"
},
"key": "x-version",
"value": ""
},
{
"disabled": false,
"description": {
"content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
"type": "text/plain"
},
"key": "x-signature",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET"
}
}
```