Skip to main content

Query Opened Orders

Interface Description

  • Function description: Paging query pending orders.

  • Applicable objects: Customers who integrate into Webull through Webull OpenAPI.

  • Request URL: /trade/orders/list-open

  • Request method:: GET

  • Frequency limit: The calling frequency of each App ID is limited to 10 times in 30 seconds.

Request Parameters

ParameterTypeRequired fieldsDescriptionExample value
account_idStringYesAccount ID20150320010101001
page_sizeintYesNumber of entries per page: default value is 10, and maximum value is 100. Integers can be filled.10
last_client_order_idStringNoUser-defined order ID is not passed, and the default check is conducted on the first page.2022021819071234

Response Parameter

ParameterTypeRequired fieldsDescriptionExample value
has_nextBooleanYesIs there a next pagetrue
orders[ ]OrderNoOrder ListReference sample code

Order:

FieldTypeDescription
account_idStringAccount ID
combo_typeStringGroup Order Types
combo_ticker_typeStringCategories of Group Orders
client_order_idStringThe ID passed in when the customer places an order
extended_hours_tradingBooleanWhether to support pre-market and post-market
order_idStringOrder ID
tifStringFor order validity period, please refer to OrderTIF in the data dictionary
itemsItem[]Order item list

Item:

FieldTypeDescription
categoryStringFor Category,please refer to Category in the data dictionary
currencyStringCurrency. Reference: Currency, such as: USD.
filled_priceStringAverage transaction price
filled_qtyStringThe number of transactions
instrument_idStringSymbol ID
last_filled_timeStringLast trade time, UTC time, time format: yyyy-MM-ddTHH:mm:ss.SSSZ. Only traded orders have value
limit_priceStringLimit price: it only has values if the order type is a limit order or stop limit order.
order_statusStringFor order status, please refer to OrderStatus in the data dictionary
order_typeStringFor order type, please refer to OrderType in the data dictionary
place_timeStringOrder time: UTC time. Time format: yyyy-MM-ddTHH:mm:ss.SSSZ
qtyStringQuantity
sideStringFor buy and sell directions, please refer to OrderSide in the data dictionary.
stop_priceStringStop loss price: it only has values when order type is stop loss order or stop loss limit.
symbolStringStock code, eg: AAPL
trailing_stop_stepStringTrailing spread: it has values when the order type is trailing stop order.
trailing_typeStringTrailing type, only has value when the order type is trailing stop order.

Request Example

from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region

api_client = ApiClient(your_app_key, your_app_secret, Region.US.value)
api = API(api_client)
response = api.order.list_open_orders(account_id, page_size, last_client_order_id)
if response.status_code == 200:
open_orders = response.json()

Response Example

Exception Example