下单

状态变更操作必须防止重复提交。

预览订单

操作名

TradeApiService.PREVIEW_ORDER = preview_order. 使用服务端方法 preview_order。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<TigerDictResponse>

ModelValue: PlaceOrderModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Auto-filled if empty	TradeClient uses DefaultAccount when empty
`SecretKey`	string	`secret_key`	null	no	—
`OrderId`	Int32	`order_id`	None (omitted if not set)	Optional	—
`SecType`	SecType	`sec_type`	None (omitted if not set)	Optional	—
`Market`	Market	`market`	None (omitted if not set)	Optional	Enum value
`Currency`	Currency	`currency`	None (omitted if not set)	Optional	—
`Symbol`	string	`symbol`	null	Required	—
`Right`	string (nullable)	`right`	null	Optional	—
`Strike`	string (nullable)	`strike`	null	Optional	—
`Expiry`	string (nullable)	`expiry`	null	Optional	—
`Action`	ActionType	`action`	None (omitted if not set)	Optional	—
`OrderType`	OrderType	`order_type`	None (omitted if not set)	Optional	price fields are conditionally required by order type
`TotalQuantity`	Int64 (nullable)	`total_quantity`	null	Optional	—
`TotalQuantityScale`	Int32 (nullable)	`total_quantity_scale`	null	Optional	—
`LimitPrice`	Double (nullable)	`limit_price`	null	Optional	conditional order-price field
`CashAmount`	Double (nullable)	`cash_amount`	null	Optional	—
`AdjustLimit`	Double	`adjust_limit`	None (omitted if not set)	Optional	—
`AuxPrice`	Double (nullable)	`aux_price`	null	Optional	conditional order-price field
`TrailingPercent`	Double (nullable)	`trailing_percent`	null	Optional	conditional order-price field
`TimeInForce`	TimeInForce	`time_in_force`	TimeInForce.DAY	Optional	—
`ExpireTime`	long	`expire_time`	None (omitted if not set)	Optional	—
`OutsideRth`	Boolean	`outside_rth`	true	Optional	—
`TradingSessionType`	TradeSession	`trading_session_type`	None (omitted if not set)	Optional	—
`Exchange`	string	`exchange`	null	Optional	—
`Multiplier`	double	`multiplier`	None (omitted if not set)	Optional	—
`LocalSymbol`	string	`local_symbol`	null	Optional	—
`AllocAccounts`	列表，元素为 string	`alloc_accounts`	null	Optional	—
`AllocShares`	列表，元素为 Double	`alloc_shares`	null	Optional	—
`AlgoStrategy`	string	`algo_strategy`	null	Optional	—
`AlgoParams`	列表，元素为 TagValue	`algo_params`	null	Optional	—
`DisplaySize`	Int64 (nullable)	`display_size`	null	Optional	—
`MinDisplaySize`	Int64 (nullable)	`min_display_size`	null	Optional	—
`CheckIntervals`	Int64 (nullable)	`check_intervals`	null	Optional	—
`PriceType`	string (nullable)	`price_type`	null	Optional	—
`StartTime`	Int64 (nullable)	`start_time`	null	Optional	Timestamp or date format; maintain chronological order
`EndTime`	Int64 (nullable)	`end_time`	null	Optional	Timestamp or date format; maintain chronological order
`UserMark`	string	`user_mark`	null	Optional	—
`AttachType`	AttachType	`attach_type`	None (omitted if not set)	Optional	—
`ProfitTakerOrderId`	Int32	`profit_taker_orderId`	None (omitted if not set)	Optional	—
`ProfitTakerPrice`	Double	`profit_taker_price`	None (omitted if not set)	Optional	—
`ProfitTakerTif`	TimeInForce	`profit_taker_tif`	None (omitted if not set)	Optional	—
`ProfitTakerRth`	Boolean	`profit_taker_rth`	None (omitted if not set)	Optional	—
`StopLossOrderType`	OrderType	`stop_loss_order_type`	None (omitted if not set)	Optional	—
`StopLossOrderId`	Int32	`stop_loss_orderId`	None (omitted if not set)	Optional	—
`StopLossPrice`	Double	`stop_loss_price`	None (omitted if not set)	Optional	—
`StopLossLimitPrice`	Double	`stop_loss_limit_price`	None (omitted if not set)	Optional	—
`StopLossTif`	TimeInForce	`stop_loss_tif`	None (omitted if not set)	Optional	—
`StopLossTrailingPercent`	Double	`stop_loss_trailing_percent`	None (omitted if not set)	Optional	—
`StopLossTrailingAmount`	Double	`stop_loss_trailing_amount`	None (omitted if not set)	Optional	—
`ComboType`	string	`combo_type`	null	Optional	—

TigerDictResponse inherits TigerResponse; its data property is 字典，键为 string，值为 object. Key SDK fields: 动态字段.

示例

TigerRequest<TigerDictResponse> request = new()
{
    ApiMethodName = TradeApiService.PREVIEW_ORDER,
    ModelValue = new PlaceOrderModel { Account = tradeClient.GetDefaultAccount, OrderId = 12345, SecType = SecType.STK, Market = Market.US, Currency = Currency.USD }
};
TigerDictResponse? response = await tradeClient.ExecuteAsync(request);

响应类型

Dictionary<string, object>? data = response?.Data; // response 或 data 缺失时为 null

下单

操作名

TradeApiService.PLACE_ORDER = place_order. 使用服务端方法 place_order。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<PlaceOrderResponse>

ModelValue: PlaceOrderModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Auto-filled if empty	TradeClient uses DefaultAccount when empty
`SecretKey`	string	`secret_key`	null	no	—
`OrderId`	Int32	`order_id`	None (omitted if not set)	Optional	—
`SecType`	SecType	`sec_type`	None (omitted if not set)	Optional	—
`Market`	Market	`market`	None (omitted if not set)	Optional	Enum value
`Currency`	Currency	`currency`	None (omitted if not set)	Optional	—
`Symbol`	string	`symbol`	null	Required	—
`Right`	string (nullable)	`right`	null	Optional	—
`Strike`	string (nullable)	`strike`	null	Optional	—
`Expiry`	string (nullable)	`expiry`	null	Optional	—
`Action`	ActionType	`action`	None (omitted if not set)	Optional	—
`OrderType`	OrderType	`order_type`	None (omitted if not set)	Optional	price fields are conditionally required by order type
`TotalQuantity`	Int64 (nullable)	`total_quantity`	null	Optional	—
`TotalQuantityScale`	Int32 (nullable)	`total_quantity_scale`	null	Optional	—
`LimitPrice`	Double (nullable)	`limit_price`	null	Optional	conditional order-price field
`CashAmount`	Double (nullable)	`cash_amount`	null	Optional	—
`AdjustLimit`	Double	`adjust_limit`	None (omitted if not set)	Optional	—
`AuxPrice`	Double (nullable)	`aux_price`	null	Optional	conditional order-price field
`TrailingPercent`	Double (nullable)	`trailing_percent`	null	Optional	conditional order-price field
`TimeInForce`	TimeInForce	`time_in_force`	TimeInForce.DAY	Optional	—
`ExpireTime`	long	`expire_time`	None (omitted if not set)	Optional	—
`OutsideRth`	Boolean	`outside_rth`	true	Optional	—
`TradingSessionType`	TradeSession	`trading_session_type`	None (omitted if not set)	Optional	—
`Exchange`	string	`exchange`	null	Optional	—
`Multiplier`	double	`multiplier`	None (omitted if not set)	Optional	—
`LocalSymbol`	string	`local_symbol`	null	Optional	—
`AllocAccounts`	列表，元素为 string	`alloc_accounts`	null	Optional	—
`AllocShares`	列表，元素为 Double	`alloc_shares`	null	Optional	—
`AlgoStrategy`	string	`algo_strategy`	null	Optional	—
`AlgoParams`	列表，元素为 TagValue	`algo_params`	null	Optional	—
`DisplaySize`	Int64 (nullable)	`display_size`	null	Optional	—
`MinDisplaySize`	Int64 (nullable)	`min_display_size`	null	Optional	—
`CheckIntervals`	Int64 (nullable)	`check_intervals`	null	Optional	—
`PriceType`	string (nullable)	`price_type`	null	Optional	—
`StartTime`	Int64 (nullable)	`start_time`	null	Optional	Timestamp or date format; maintain chronological order
`EndTime`	Int64 (nullable)	`end_time`	null	Optional	Timestamp or date format; maintain chronological order
`UserMark`	string	`user_mark`	null	Optional	—
`AttachType`	AttachType	`attach_type`	None (omitted if not set)	Optional	—
`ProfitTakerOrderId`	Int32	`profit_taker_orderId`	None (omitted if not set)	Optional	—
`ProfitTakerPrice`	Double	`profit_taker_price`	None (omitted if not set)	Optional	—
`ProfitTakerTif`	TimeInForce	`profit_taker_tif`	None (omitted if not set)	Optional	—
`ProfitTakerRth`	Boolean	`profit_taker_rth`	None (omitted if not set)	Optional	—
`StopLossOrderType`	OrderType	`stop_loss_order_type`	None (omitted if not set)	Optional	—
`StopLossOrderId`	Int32	`stop_loss_orderId`	None (omitted if not set)	Optional	—
`StopLossPrice`	Double	`stop_loss_price`	None (omitted if not set)	Optional	—
`StopLossLimitPrice`	Double	`stop_loss_limit_price`	None (omitted if not set)	Optional	—
`StopLossTif`	TimeInForce	`stop_loss_tif`	None (omitted if not set)	Optional	—
`StopLossTrailingPercent`	Double	`stop_loss_trailing_percent`	None (omitted if not set)	Optional	—
`StopLossTrailingAmount`	Double	`stop_loss_trailing_amount`	None (omitted if not set)	Optional	—
`ComboType`	string	`combo_type`	null	Optional	—

PlaceOrderResponse inherits TigerResponse; its data property is PlaceOrderItem. Key SDK fields: Id: long, SubIds: list of Int64, Orders: list of TradeOrder.

示例

TigerRequest<PlaceOrderResponse> request = new()
{
    ApiMethodName = TradeApiService.PLACE_ORDER,
    ModelValue = new PlaceOrderModel { Account = tradeClient.GetDefaultAccount, OrderId = 12345, SecType = SecType.STK, Market = Market.US, Currency = Currency.USD }
};
PlaceOrderResponse? response = await tradeClient.ExecuteAsync(request);

响应类型

PlaceOrderItem? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "id": 123458,
    "orderId": 789014,
    "subIds": []
  }
}