跳到主要內容

委托下单

该接口用于港美股,窝轮,期权的委托下单

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 / TSMAMT 订单必填
trailing_percentstringNO跟踪涨跌幅

TSLPPCT / TSMPCT 订单必填
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