下单

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

预览订单

操作名

TradeApiService.PREVIEW_ORDER = preview_order。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<TigerDictResponse>

ModelValue: PlaceOrderModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`SecretKey`	string	`secret_key`	null	no	—
`OrderId`	Int32	`order_id`	CLR 默认值；序列化时省略	Optional	—
`SecType`	SecType	`sec_type`	CLR 默认值；序列化时省略	Optional	—
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`Currency`	Currency	`currency`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`OrderType`	OrderType	`order_type`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`OutsideRth`	Boolean	`outside_rth`	true	Optional	—
`TradingSessionType`	TradeSession	`trading_session_type`	CLR 默认值；序列化时省略	Optional	—
`Exchange`	string	`exchange`	null	Optional	—
`Multiplier`	double	`multiplier`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerOrderId`	Int32	`profit_taker_orderId`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerPrice`	Double	`profit_taker_price`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerTif`	TimeInForce	`profit_taker_tif`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerRth`	Boolean	`profit_taker_rth`	CLR 默认值；序列化时省略	Optional	—
`StopLossOrderType`	OrderType	`stop_loss_order_type`	CLR 默认值；序列化时省略	Optional	—
`StopLossOrderId`	Int32	`stop_loss_orderId`	CLR 默认值；序列化时省略	Optional	—
`StopLossPrice`	Double	`stop_loss_price`	CLR 默认值；序列化时省略	Optional	—
`StopLossLimitPrice`	Double	`stop_loss_limit_price`	CLR 默认值；序列化时省略	Optional	—
`StopLossTif`	TimeInForce	`stop_loss_tif`	CLR 默认值；序列化时省略	Optional	—
`StopLossTrailingPercent`	Double	`stop_loss_trailing_percent`	CLR 默认值；序列化时省略	Optional	—
`StopLossTrailingAmount`	Double	`stop_loss_trailing_amount`	CLR 默认值；序列化时省略	Optional	—
`ComboType`	string	`combo_type`	null	Optional	—

TigerDictResponse inherits TigerResponse; its data property is Dictionary<string, object>.

示例

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

Data 字段

类型	SDK 约定
`Dictionary<string, object>`	动态字典；SDK 未定义固定键或嵌套对象类型。

下单

操作名

TradeApiService.PLACE_ORDER = place_order。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<PlaceOrderResponse>

ModelValue: PlaceOrderModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`SecretKey`	string	`secret_key`	null	no	—
`OrderId`	Int32	`order_id`	CLR 默认值；序列化时省略	Optional	—
`SecType`	SecType	`sec_type`	CLR 默认值；序列化时省略	Optional	—
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`Currency`	Currency	`currency`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`OrderType`	OrderType	`order_type`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`OutsideRth`	Boolean	`outside_rth`	true	Optional	—
`TradingSessionType`	TradeSession	`trading_session_type`	CLR 默认值；序列化时省略	Optional	—
`Exchange`	string	`exchange`	null	Optional	—
`Multiplier`	double	`multiplier`	CLR 默认值；序列化时省略	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`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerOrderId`	Int32	`profit_taker_orderId`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerPrice`	Double	`profit_taker_price`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerTif`	TimeInForce	`profit_taker_tif`	CLR 默认值；序列化时省略	Optional	—
`ProfitTakerRth`	Boolean	`profit_taker_rth`	CLR 默认值；序列化时省略	Optional	—
`StopLossOrderType`	OrderType	`stop_loss_order_type`	CLR 默认值；序列化时省略	Optional	—
`StopLossOrderId`	Int32	`stop_loss_orderId`	CLR 默认值；序列化时省略	Optional	—
`StopLossPrice`	Double	`stop_loss_price`	CLR 默认值；序列化时省略	Optional	—
`StopLossLimitPrice`	Double	`stop_loss_limit_price`	CLR 默认值；序列化时省略	Optional	—
`StopLossTif`	TimeInForce	`stop_loss_tif`	CLR 默认值；序列化时省略	Optional	—
`StopLossTrailingPercent`	Double	`stop_loss_trailing_percent`	CLR 默认值；序列化时省略	Optional	—
`StopLossTrailingAmount`	Double	`stop_loss_trailing_amount`	CLR 默认值；序列化时省略	Optional	—
`ComboType`	string	`combo_type`	null	Optional	—

PlaceOrderResponse inherits TigerResponse; its data property is PlaceOrderItem.

示例

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

Data 字段（PlaceOrderItem）

字段	API 字段	C# 类型	说明
`Id`	`id`	`long`	已提交订单的内部标识
`SubIds`	`subIds`	`List<Int64>`	子订单标识列表
`Orders`	`orders`	`List<TradeOrder>`	订单详情列表

Orders 中每个 TradeOrder 的完整字段见订单查询的 TradeOrder 字段。

返回示例

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

频率限制

基础额度：每分钟 120 次。