# List Open Orders
Retrieves pending orders by page. Orders can be modified or cancelled based on client_order_id.
# OpenAPI definition
```json
{
"info": {
"title": "Webull OpenAPI Documentation",
"description": "The Webull OpenAPI enables integration of trading APIs, market data for building trading applications and brokerage solutions. It supports HTTP-based historical and real-time market data and MQTT streaming via WebSocket/TCP, along with SDKs, secure authentication, and APIs for orders, accounts, and event contract trading.",
"contact": {
"name": "Webull Developer Support",
"url": "https://www.webull.hk/en/help",
"email": "webull-api-support@webull.com"
},
"version": "2.0",
"x-logo": {
"url": "static/png/logo.png"
}
},
"servers": [
{
"url": "https://api.sandbox.webull.hk"
}
],
"path": "/trading/orders/open-orders/list",
"method": "get",
"tags": [
"Order Query"
],
"description": "Retrieves pending orders by page. Orders can be modified or cancelled based on client_order_id.",
"operationId": "orderOpen",
"parameters": [
{
"name": "account_id",
"in": "query",
"description": "Account identifier.",
"required": true,
"schema": {
"type": "String"
},
"example": 20150320010101000
},
{
"name": "pagination_key",
"in": "query",
"description": "Pagination key from previous response for next page.",
"required": false,
"schema": {
"type": "String"
},
"example": "eyJ2IjoxLCJsYXN0SWQiOiI5MTMyNDQ3NjkiLCJwYWdlSW===="
},
{
"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-access-token",
"in": "header",
"description": "An access token is a credential that represents the authorization granted to a client (e.g., a user or an application) to access specific protected resources on behalf of a user, without needing to share their password.",
"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": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "Result data list",
"items": {
"required": [
"client_order_id",
"combo_type",
"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).
Futures Trading currently support only the NORMAL type.
• 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)
Note: When placing take-profit/stop-loss orders to sell and close an existing position, submit only STOP_PROFIT/STOP_LOSS sub-orders (side = SELL) under the same client_combo_order_id; no MASTER order is required or supported in this scenario, since no new position is being opened.
Note: OTO, OCO and OTOCO combo types are only supported for stock (EQUITY) orders; option orders (including option_strategy = SINGLE) do not support OTO, OCO or OTOCO.
Sub-order quantity limits by combo_type:\n\n| Scenario | combo_type | Supported order_type | Quantity | Description |\n|---|---|---|---|---|\n| Take-Profit/Stop-Loss | MASTER | MARKET, LIMIT | 1 | Master Order |\n| Take-Profit/Stop-Loss | STOP_PROFIT | LIMIT | 0-1 | Take Profit Order |\n| Take-Profit/Stop-Loss | STOP_LOSS | STOP_LOSS | 0-1 | Stop Loss Order |\n| OTO | MASTER | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | 1 | Master Order |\n| OTO | OTO | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | 1-6 | Triggered Order(s) |\n| OCO | OCO | LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | 2-6 | Mutually Cancelling Orders |\n| OTOCO | MASTER | MARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | 1 | Master Order |\n| OTOCO | OTOCO | LIMIT, STOP_LOSS, STOP_LOSS_LIMIT | 1-6 | OCO Order Set Triggered by MASTER |",
"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
• TOUCH_MKT: Touch Market Order
• TOUCH_LMT: Touch Limit Order
• TRAILING_STOP_LOSS: Trailing Stop Order
• TRAILING_STOP_LOSS_LIMIT: Trailing Stop Limit 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
• ODD_LOT_LIMIT: Odd Lot 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",
"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": "STOCK",
"enum": [
"EQUITY",
"OPTION",
"FUTURES"
]
},
"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.
• GTD: order that will automatically expire and be cancelled at a specific future date and time,Currently only supports the US market.
• 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",
"GTD",
"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 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-dd'T'HH:mm:ss.SSSZ",
"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-dd'T'HH:mm:ss.SSSZ",
"example": "2025-11-11T05:44:35.385Z"
},
"legs": {
"type": "array",
"description": "Leg detail",
"items": {
"required": [
"option_category",
"option_expire_date",
"option_type",
"quantity",
"side",
"strike_price",
"symbol"
],
"type": "object",
"properties": {
"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: Indicates a single-leg options order",
"example": "SINGLE",
"enum": [
"SINGLE"
]
},
"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": "OrderListLeg"
}
}
},
"description": "Order Details",
"title": "OrderListItem"
}
}
},
"description": "Result data list",
"title": "OrderListResult"
}
},
"pagination_key": {
"type": "string",
"description": "Pagination key for next page. If absent, indicates this is the last page.",
"example": "eyJ2IjoxLCJsYXN0SWQiOiI5MTMyNDQ3NjkiLCJwYWdlSW===="
}
},
"description": "Paginated result with cursor-based pagination",
"title": "PaginatedResultVoOrderListResult"
}
}
}
},
"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": "List Open Orders",
"description": {
"content": "Retrieves pending orders by page. Orders can be modified or cancelled based on client_order_id.",
"type": "text/plain"
},
"url": {
"path": [
"trading",
"orders",
"open-orders",
"list"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"description": {
"content": "(Required) Account identifier.",
"type": "text/plain"
},
"key": "account_id",
"value": ""
},
{
"disabled": false,
"description": {
"content": "Pagination key from previous response for next page.",
"type": "text/plain"
},
"key": "pagination_key",
"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) An access token is a credential that represents the authorization granted to a client (e.g., a user or an application) to access specific protected resources on behalf of a user, without needing to share their password.",
"type": "text/plain"
},
"key": "x-access-token",
"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"
}
}
```