# Place Order
Places equity and options orders. The A-Share trading function is disabled by default.
# 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/place",
"method": "post",
"tags": [
"Trading"
],
"description": "Places equity and options orders. The A-Share trading function is disabled by default.",
"operationId": "Common Order Place",
"parameters": [
{
"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"
}
}
],
"requestBody": {
"description": "Order Place",
"content": {
"application/json": {
"schema": {
"required": [
"account_id",
"new_orders"
],
"type": "object",
"properties": {
"account_id": {
"type": "string",
"description": "Account identifier",
"example": "93IUJ28O9VO2KBGHDHR4H9"
},
"client_combo_order_id": {
"type": "string",
"description": "Unique client-defined identifier for the combined order
If combo_type = NORMAL and client_combo_order_id not need to set
If combo_type != NORMAL and client_combo_order_id not provided
the server will automatically generate one.
To sell and close an existing position with take-profit/stop-loss, submit only STOP_PROFIT/STOP_LOSS sub-orders (side = SELL) grouped under the same client_combo_order_id; no MASTER order is required in this scenario.",
"example": "0KGOHL4PR2SLC0DKIND4TI0001"
},
"new_orders": {
"type": "array",
"description": "Order Details",
"items": {
"required": [
"client_order_id",
"combo_type",
"entrust_type",
"instrument_type",
"market",
"order_type",
"side",
"symbol",
"time_in_force"
],
"type": "object",
"properties": {
"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"
},
"client_order_id": {
"type": "string",
"description": "Unique client-defined identifier for the order.
Maximum length is 32 characters and must be unique per account.
Allowed characters: letters (A–Z, a–z), digits (0–9), hyphen (-), underscore (_).
Used to track or reference the order when interacting with the system.",
"example": "0KGOHL4PR2SLC0DKIND4TI0002"
},
"instrument_type": {
"type": "string",
"description": "Type of financial instrument associated with the request.",
"example": "EQUITY",
"enum": [
"EQUITY",
"OPTION",
"FUTURES"
]
},
"market": {
"type": "string",
"description": "Market code indicating the trading venue or regulatory region of the financial instrument.Used together with symbol and instrument_type to uniquely identify a tradable instrument.",
"example": "US",
"enum": [
"US",
"HK",
"CN"
]
},
"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": "BULL"
},
"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"
]
},
"entrust_type": {
"type": "string",
"description": "Specifies the method for placing the order.
• QTY: Order specified by quantity of shares or units.
• AMOUNT: Order specified by total cash amount, applicable for fractional share trading of US stocks.",
"example": "QTY",
"enum": [
"QTY",
"AMOUNT"
]
},
"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"
]
},
"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": "Transaction quantity. You can specify decimals when placing fractional lot orders for US stocks.",
"example": "1"
},
"total_cash_amount": {
"type": "string",
"description": "The total order amount is currently only applicable to US stock fractional share transactions and when the order is placed by amount.",
"example": "100.4"
},
"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"
]
},
"sender_sub_id": {
"type": "string",
"description": "Identifier for the firm or sub-account in third-party transactions.
For brokers, this field should contain the UUID of the broker user. Used to distinguish different entities or users within the same firm."
},
"no_party_ids": {
"type": "array",
"description": "List of party identifiers. Applicable only for Hong Kong stock orders. Required for Relevant Regulated Intermediaries; should be omitted otherwise.",
"items": {
"required": [
"party_id",
"party_id_source",
"party_role"
],
"type": "object",
"properties": {
"party_id": {
"type": "string",
"description": "ID of the broker client submitting the order. Format examples:
• CE Number Format: ABC123
• BCAN Format: 2568
Combined format example: ABC123.2568
Must be certified by the BCAN system of the Hong Kong Stock Exchange.",
"example": "ABC123.2568"
},
"party_id_source": {
"type": "string",
"description": "Source of the party ID. Value must be \"D\" (Proprietary/Custom Code).",
"example": "D"
},
"party_role": {
"type": "string",
"description": "Role of the party. Value must be \"3\" (Client ID, BCAN Field).",
"example": "3"
}
},
"description": "List of party identifiers. Applicable only for Hong Kong stock orders. Required for Relevant Regulated Intermediaries; should be omitted otherwise.",
"title": "PartyId"
}
},
"expire_date": {
"type": "string",
"description": "GTD order expire date. format (UTC). The value must be in yyyy-MM-dd format",
"example": "2026-01-01"
},
"option_strategy": {
"type": "string",
"description": "Type of options strategy
• SINGLE: Indicates a single-leg options order",
"example": "SINGLE",
"enum": [
"SINGLE"
]
},
"legs": {
"type": "array",
"description": "Option leg detail. Only required when placing option orders.",
"items": {
"required": [
"instrument_type",
"market",
"side",
"symbol"
],
"type": "object",
"properties": {
"instrument_type": {
"type": "string",
"description": "Type of financial instrument associated with the request.",
"example": "OPTION",
"enum": [
"EQUITY",
"OPTION",
"FUTURES"
]
},
"market": {
"type": "string",
"description": "Market code indicating the trading venue or regulatory region of the financial instrument.Used together with symbol and instrument_type to uniquely identify a tradable instrument.",
"example": "US",
"enum": [
"US",
"HK",
"CN"
]
},
"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"
]
},
"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": "11.0"
},
"option_expire_date": {
"type": "string",
"description": "Expiration date. Format: yyyy-MM-dd",
"example": "2025-08-01"
},
"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"
]
},
"quantity": {
"type": "string",
"description": "Quantity of the order or strategy leg.
For stock legs, specifies the number of shares to transact
For option legs, specifies the number of option contracts to transact for this leg and is expressed in whole contracts.",
"example": "1"
}
},
"description": "Option leg detail. Only required when placing option orders.",
"title": "OptionCommonPlaceLegParam"
}
}
},
"description": "Order Details",
"title": "OrderCommonPlaceItemParam"
}
}
},
"title": "OrderCommonPlaceParam"
},
"examples": {
"Equity": {
"summary": "Stock Limit Order",
"description": "Equity",
"value": {
"account_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "NORMAL",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"limit_price": "180.00",
"quantity": "10",
"side": "BUY",
"time_in_force": "DAY",
"support_trading_session": "CORE",
"entrust_type": "QTY"
}
]
}
},
"Single Option": {
"summary": "Single Leg Order",
"description": "Single Option",
"value": {
"account_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "NORMAL",
"order_type": "LIMIT",
"limit_price": "11.25",
"quantity": "1",
"option_strategy": "SINGLE",
"side": "BUY",
"time_in_force": "DAY",
"entrust_type": "QTY",
"instrument_type": "OPTION",
"market": "US",
"symbol": "AAPL",
"legs": [
{
"side": "BUY",
"quantity": "1",
"symbol": "AAPL",
"strike_price": "220.00",
"option_expire_date": "2026-12-18",
"instrument_type": "OPTION",
"option_type": "CALL",
"market": "US"
}
]
}
]
}
},
"Buy-to-Open TP/SL(Equity)": {
"summary": "Open Position with Take-Profit and Stop-Loss (MASTER + STOP_PROFIT + STOP_LOSS)",
"description": "Buy-to-Open TP/SL(Equity)",
"value": {
"account_id": "",
"client_combo_order_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "MASTER",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"quantity": "10",
"side": "BUY",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"limit_price": "309.53"
},
{
"client_order_id": "",
"combo_type": "STOP_PROFIT",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"limit_price": "378.33"
},
{
"client_order_id": "",
"combo_type": "STOP_LOSS",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "STOP_LOSS",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"stop_price": "292.34"
}
]
}
},
"Sell-to-Close TP/SL(Equity)": {
"summary": "Sell to Close an Existing Position with Take-Profit and Stop-Loss (no MASTER order)",
"description": "Sell-to-Close TP/SL(Equity)",
"value": {
"account_id": "",
"client_combo_order_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "STOP_PROFIT",
"symbol": "TSLA",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"limit_price": "326.59"
},
{
"client_order_id": "",
"combo_type": "STOP_LOSS",
"symbol": "TSLA",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "STOP_LOSS",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"stop_price": "252.36"
}
]
}
},
"OTO": {
"summary": "One-Triggers-the-Other: Master Order Triggers a Single Follow-up Order",
"description": "OTO",
"value": {
"account_id": "",
"client_combo_order_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "MASTER",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"limit_price": "180.00",
"quantity": "10",
"side": "BUY",
"time_in_force": "DAY",
"support_trading_session": "CORE",
"entrust_type": "QTY"
},
{
"client_order_id": "",
"combo_type": "OTO",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"limit_price": "200.00",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE"
}
]
}
},
"OCO": {
"summary": "One-Cancels-the-Other: Two Sub-orders on an Existing Position, Filling One Cancels the Other",
"description": "OCO",
"value": {
"account_id": "",
"client_combo_order_id": "",
"new_orders": [
{
"market": "US",
"instrument_type": "EQUITY",
"symbol": "AAPL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"combo_type": "OCO",
"order_type": "LIMIT",
"side": "BUY",
"quantity": "1",
"limit_price": "360.00",
"client_order_id": ""
},
{
"market": "US",
"instrument_type": "EQUITY",
"symbol": "AAPL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"combo_type": "OCO",
"order_type": "LIMIT",
"side": "BUY",
"quantity": "1",
"limit_price": "370.80",
"client_order_id": ""
}
]
}
},
"OTOCO": {
"summary": "One-Triggers-a-One-Cancels-the-Other: Master Order Triggers an OCO Order Set",
"description": "OTOCO",
"value": {
"account_id": "",
"client_combo_order_id": "",
"new_orders": [
{
"client_order_id": "",
"combo_type": "MASTER",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"limit_price": "180.00",
"quantity": "10",
"side": "BUY",
"time_in_force": "DAY",
"support_trading_session": "CORE",
"entrust_type": "QTY"
},
{
"client_order_id": "",
"combo_type": "OTOCO",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "LIMIT",
"limit_price": "200.00",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE"
},
{
"client_order_id": "",
"combo_type": "OTOCO",
"symbol": "AAPL",
"instrument_type": "EQUITY",
"market": "US",
"order_type": "STOP_LOSS",
"stop_price": "170.00",
"quantity": "10",
"side": "SELL",
"time_in_force": "DAY",
"entrust_type": "QTY",
"support_trading_session": "CORE"
}
]
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"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 for NORMAL order.",
"example": "0KGOHL4PR2SLC0DKIND4TI0002"
},
"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 when placing the order for NORMAL order.",
"example": "80HG7CPSFDPCAL3TP66LKBAS69"
}
},
"title": "OrderCommonWriteResult"
}
}
}
},
"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": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error_code": {
"type": "string",
"description": "error code",
"example": "OPENAPI_NO_NIGHT_TRADING_TIME"
},
"message": {
"type": "string",
"description": "error message",
"example": "The current period does not support placing night orders"
}
},
"description": "Business Response",
"title": "BizResponse"
}
}
}
},
"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"
}
}
}
}
}
}
},
"jsonRequestBodyExample": {
"account_id": "93IUJ28O9VO2KBGHDHR4H9",
"client_combo_order_id": "0KGOHL4PR2SLC0DKIND4TI0001",
"new_orders": [
{
"combo_type": "NORMAL",
"client_order_id": "0KGOHL4PR2SLC0DKIND4TI0002",
"instrument_type": "EQUITY",
"market": "US",
"symbol": "BULL",
"order_type": "MARKET",
"entrust_type": "QTY",
"support_trading_session": "CORE",
"time_in_force": "DAY",
"side": "BUY",
"quantity": "1",
"total_cash_amount": "100.4",
"limit_price": "11.0",
"stop_price": "11.0",
"trailing_type": "AMOUNT",
"trailing_stop_step": "1",
"trailing_limit_price_offset": "11.0",
"trigger_price_type": "PRICE",
"sender_sub_id": "string",
"no_party_ids": [
{
"party_id": "ABC123.2568",
"party_id_source": "D",
"party_role": "3"
}
],
"expire_date": "2026-01-01",
"option_strategy": "SINGLE",
"legs": [
{
"instrument_type": "OPTION",
"market": "US",
"symbol": "AAPL",
"side": "BUY",
"strike_price": "11.0",
"option_expire_date": "2025-08-01",
"option_type": "CALL",
"quantity": "1"
}
]
}
]
},
"postman": {
"name": "Place Order",
"description": {
"content": "Places equity and options orders. The A-Share trading function is disabled by default.",
"type": "text/plain"
},
"url": {
"path": [
"trading",
"orders",
"place"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"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": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "",
"options": {
"raw": {
"language": "json"
}
}
}
}
}
```