跳到主要內容

委托下單

該接口用於港美股,窩輪,期權的委托下單

Request

HTTP MethodPOST
HTTP URL/v1/trade/order

Parameters

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

NameTypeRequiredDescription
symbolstringYES股票代碼,使用 ticker.region 格式,例如:AAPL.US
order_typestringYES訂單類型
submitted_pricestringNO下單價格,例如:388.5

LO / ELO / ALO / ODD / LIT 訂單必填
submitted_quantitystringYES下單數量,例如:100
trigger_pricestringNO觸發價格,例如:388.5

LIT / MIT 訂單必填
limit_offsetstringNO指定價差

TSLPAMT / TSLPPCT 訂單必填
trailing_amountstringNO跟蹤金額

TSLPAMT 訂單必填
trailing_percentstringNO跟蹤漲跌幅

TSLPPCT 訂單必填
expire_datestringNO長期單過期時間,格式為 YYYY-MM-DD, 例如:2022-12-05

time_in_force 為 GTD 時必填
sidestringYES買賣方向

可選值:
Buy - 買入
Sell - 賣出
outside_rthstringNO是否允許盤前盤後,美股必填

可選值:
RTH_ONLY - 不允許盤前盤後
ANY_TIME - 允許盤前盤後
time_in_forcestringYES訂單有效期類型

可選值:
Day - 當日有效
GTC - 撤單前有效
GTD - 到期前有效
remarkstringNO備註 (最大 64 字符)

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

StatusDescriptionSchema
200提交成功,訂單已委托。None
400下單被拒絕,請求參數錯誤。None