期权行权

这五项既是 TradeApiService 操作常量，也是 TradeClient 上的便捷异步方法。

行权检查

操作名

TradeApiService.OPTION_EXERCISE_CHECK = option_exercise_check; convenience method: CheckOptionExerciseAsync.

请求

TigerRequest<OptionExerciseCheckResponse>

ModelValue: OptionExerciseCheckModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	no SDK validation	see operation constraints
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`ContractId`	long	`contract_id`	None (omitted if not set)	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints
`Quantity`	double	`quantity`	None (omitted if not set)	no SDK validation	see operation constraints
`ExecutingDate`	string	`executing_date`	null	no SDK validation	see operation constraints
`IsForce`	bool (nullable)	`is_force`	null	no SDK validation	see operation constraints
`ItmRate`	int (nullable)	`itm_rate`	null	no SDK validation	see operation constraints

OptionExerciseCheckResponse inherits TigerResponse; its data property is OptionExerciseCheckItem. Key fields follow the concrete response model; submit/cancel data is intentionally object in this SDK.

示例

OptionExerciseCheckResponse response = await tradeClient.CheckOptionExerciseAsync(1234567890L, "Exercise", 1, "2026-08-21", false);
if (!response.IsSuccess()) throw new InvalidOperationException(response.Message);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "exercisable": true,
    "identifier": "AAPL  250808C00230000",
    "position": 5,
    "maxExerciseQuantity": 5
  }
}

行权持仓

操作名

TradeApiService.OPTION_EXERCISE_POSITION = option_exercise_position; convenience method: GetOptionExercisePositionsAsync.

请求

TigerRequest<OptionExercisePositionResponse>

ModelValue: OptionExercisePositionModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	no SDK validation	see operation constraints
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints

OptionExercisePositionResponse inherits TigerResponse; its data property is OptionExercisePositionPage. Key fields follow the concrete response model; submit/cancel data is intentionally object in this SDK.

示例

OptionExercisePositionResponse response = await tradeClient.GetOptionExercisePositionsAsync("Exercise");
if (!response.IsSuccess()) throw new InvalidOperationException(response.Message);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "identifier": "AAPL  250808C00230000",
      "symbol": "AAPL",
      "strike": 230.0,
      "right": "CALL",
      "expiry": "2025-08-08",
      "position": 5,
      "exercisableQty": 5
    }
  ]
}

提交行权

操作名

TradeApiService.OPTION_EXERCISE_SUBMIT = option_exercise_submit; convenience method: SubmitOptionExerciseAsync.

请求

TigerRequest<OptionExerciseSubmitResponse>

ModelValue: OptionExerciseSubmitModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	no SDK validation	see operation constraints
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`ContractId`	long	`contract_id`	None (omitted if not set)	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints
`Quantity`	double	`quantity`	None (omitted if not set)	no SDK validation	see operation constraints
`ExecutingDate`	string	`executing_date`	null	no SDK validation	see operation constraints
`IsForce`	bool (nullable)	`is_force`	null	no SDK validation	see operation constraints
`ItmRate`	int (nullable)	`itm_rate`	null	no SDK validation	see operation constraints

OptionExerciseSubmitResponse inherits TigerResponse; its data property is object. Key fields follow the concrete response model; submit/cancel data is intentionally object in this SDK.

示例

OptionExerciseSubmitResponse response = await tradeClient.SubmitOptionExerciseAsync(1234567890L, "Exercise", 1, "2026-08-21", false);
if (!response.IsSuccess()) throw new InvalidOperationException(response.Message);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "id": 200001
  }
}

行权记录

操作名

TradeApiService.OPTION_EXERCISE_RECORD = option_exercise_record; convenience method: GetOptionExerciseRecordsAsync.

请求

TigerRequest<OptionExerciseRecordResponse>

ModelValue: OptionExerciseRecordModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	no SDK validation	see operation constraints
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints
`Status`	string	`status`	null	no SDK validation	see operation constraints
`Symbol`	string	`symbol`	null	no SDK validation	see operation constraints
`OrderBy`	string	`order_by`	null	no SDK validation	see operation constraints
`Page`	int	`page`	1	no SDK validation	see operation constraints
`Size`	int	`size`	20	no SDK validation	see operation constraints

OptionExerciseRecordResponse inherits TigerResponse; its data property is OptionExerciseRecordPage. Key fields follow the concrete response model; submit/cancel data is intentionally object in this SDK.

示例

OptionExerciseRecordResponse response = await tradeClient.GetOptionExerciseRecordsAsync(page: 1, size: 20);
if (!response.IsSuccess()) throw new InvalidOperationException(response.Message);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "id": 200001,
      "identifier": "AAPL  250808C00230000",
      "direction": "EXERCISE",
      "quantity": 5,
      "status": "SUBMITTED",
      "createTime": 1785441600000
    }
  ]
}

取消行权

操作名

TradeApiService.OPTION_EXERCISE_CANCEL = option_exercise_cancel; convenience method: CancelOptionExerciseAsync.

请求

TigerRequest<OptionExerciseCancelResponse>

ModelValue: OptionExerciseCancelModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	no SDK validation	see operation constraints
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`Id`	long	`id`	None (omitted if not set)	no SDK validation	see operation constraints

OptionExerciseCancelResponse inherits TigerResponse; its data property is object. Key fields follow the concrete response model; submit/cancel data is intentionally object in this SDK.

示例

OptionExerciseCancelResponse response = await tradeClient.CancelOptionExerciseAsync(1234567890L);
if (!response.IsSuccess()) throw new InvalidOperationException(response.Message);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "id": 200001,
    "status": "CANCELLED"
  }
}