Submit Order

This API is used to submit order for HK and US stocks, warrant and option

Request

HTTP Method	POST
HTTP URL	/v1/trade/order

Parameters

Content-Type: application/json; charset=utf-8

Name	Type	Required	Description
symbol	string	YES	Stock symbol, use ticker.region format, example: AAPL.US
order_type	string	YES	Order Type
submitted_price	string	NO	Submitted price, example: 388.5 LO / ELO / ALO / ODD / LIT Order Required
submitted_quantity	string	YES	Submitted quantity, example: 100
trigger_price	string	NO	Trigger price, example: 388.5 LIT / MIT Order Required
limit_offset	string	NO	Limit offset amount TSLPAMT / TSLPPCT Order Required
trailing_amount	string	NO	Trailing amount TSLPAMT Order Required
trailing_percent	string	NO	Trailing percent TSLPPCT Order Required
expire_date	string	NO	Long term order expire date, format YYYY-MM-DD, example: 2022-12-05 Required when time_in_force is GTD
side	string	YES	Order Side Enum Value: Buy Sell
outside_rth	string	NO	Enable or disable outside regular trading hours Enum Value: RTH_ONLY - regular trading hour only ANY_TIME - any time"
time_in_force	string	YES	Time in force Type Enum Value: Day - Day Order GTC - Good Til Canceled Order GTD - Good Til Date Order
remark	string	NO	remark (Maximum 64 characters)

Request Example

from decimal import Decimal
from longport.openapi import TradeContext, Config, OrderType, OrderSide, TimeInForceType

# Load configuration from environment variables
config = Config.from_env()

# Create a context for trade APIs
ctx = TradeContext(config)

# Submit order
resp = ctx.submit_order("700.HK", OrderType.LO, OrderSide.Buy, Decimal(
  "500"), TimeInForceType.Day, submitted_price=Decimal("50"), remark="Hello from Python SDK")
print(resp)

Response

Response Headers

• Content-Type: application/json

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": 683615454870679600
  }
}

Response Status

Status	Description	Schema
200	The submission was successful and the order was commissioned.	None
400	The submit was rejected with an incorrect request parameter.	None