期权行权

这五项既是 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`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`ContractId`	long	`contract_id`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints
`Quantity`	double	`quantity`	CLR 默认值；序列化时省略	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.

示例

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

Data 字段（OptionExerciseCheckItem）

字段	API 字段	C# 类型	说明
`AvailableQuantity`	`availableQuantity`	`double?`	可行权数量
`Position`	`position`	`double?`	期权持仓数量
`StkPosition`	`stkPosition`	`double?`	标的证券持仓数量
`StkPositionChange`	`stkPositionChange`	`double?`	标的证券持仓变动数量
`StkPositionBefore`	`stkPositionBefore`	`double?`	行权前标的证券持仓数量
`StkPositionAfter`	`stkPositionAfter`	`double?`	行权后标的证券持仓数量
`Symbol`	`symbol`	`string`	期权代码

频率限制

基础额度：每分钟 60 次。

行权持仓

操作名

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`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`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.

示例

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

响应类型

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

Data 字段（OptionExercisePositionPage）

字段	API 字段	C# 类型	说明
`Items`	`items`	`List<OptionExercisePosition>`	行权持仓列表
`PageNum`	`pageNum`	`int?`	当前页码
`PageSize`	`pageSize`	`int?`	每页数量
`ItemCount`	`itemCount`	`int?`	总记录数
`PageCount`	`pageCount`	`int?`	总页数

Items 中每个 OptionExercisePosition：

字段	API 字段	C# 类型	说明
`ContractId`	`contractId`	`long?`	合约标识
`Symbol`	`symbol`	`string`	期权代码
`StkSymbol`	`stkSymbol`	`string`	标的证券代码
`ExpireDate`	`expireDate`	`string`	到期日
`Strike`	`strike`	`string`	行权价
`CallPut`	`callPut`	`string`	看涨或看跌方向
`Market`	`market`	`string`	所属市场
`AccountId`	`accountId`	`long?`	账户标识
`Position`	`position`	`double?`	持仓数量
`AvailableQuantity`	`availableQuantity`	`double?`	可行权数量

频率限制

基础额度：每分钟 60 次。

提交行权

操作名

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`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`ContractId`	long	`contract_id`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Type`	string	`type`	null	no SDK validation	see operation constraints
`Quantity`	double	`quantity`	CLR 默认值；序列化时省略	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.

示例

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

Data 字段

类型	SDK 约定
`object`	SDK 未定义成员或键。

频率限制

基础额度：每分钟 60 次。

行权记录

操作名

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`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`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.

示例

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

响应类型

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

Data 字段（OptionExerciseRecordPage）

字段	API 字段	C# 类型	说明
`Items`	`items`	`List<OptionExerciseRecord>`	行权记录列表
`PageNum`	`pageNum`	`int?`	当前页码
`PageSize`	`pageSize`	`int?`	每页数量
`ItemCount`	`itemCount`	`int?`	总记录数
`PageCount`	`pageCount`	`int?`	总页数

Items 中每个 OptionExerciseRecord：

字段	API 字段	C# 类型	说明
`Id`	`id`	`long?`	行权记录标识
`AccountId`	`accountId`	`long?`	账户标识
`ContractId`	`contractId`	`long?`	合约标识
`Symbol`	`symbol`	`string`	期权代码
`StkSymbol`	`stkSymbol`	`string`	标的证券代码
`ExpireDate`	`expireDate`	`string`	到期日
`Strike`	`strike`	`string`	行权价
`CallPut`	`callPut`	`string`	看涨或看跌方向
`Type`	`type`	`string`	行权或到期类型
`RequestQuantity`	`requestQuantity`	`double?`	请求数量
`Quantity`	`quantity`	`double?`	行权数量
`Status`	`status`	`string`	行权状态
`ExecutingDate`	`executingDate`	`string`	执行日期
`ItmRate`	`itmRate`	`int?`	实值比例
`IsForce`	`isForce`	`bool?`	是否强制行权
`Reason`	`reason`	`string`	状态原因

频率限制

基础额度：每分钟 60 次。

取消行权

操作名

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`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints
`Account`	string (nullable)	`account`	null	Auto-filled if empty	为空时 `TradeClient` 从 `TigerConfig.DefaultAccount` 注入；若仍为空则验证失败
`SecretKey`	string	`secret_key`	null	no SDK validation	see operation constraints
`Id`	long	`id`	CLR 默认值；序列化时省略	no SDK validation	see operation constraints

OptionExerciseCancelResponse inherits TigerResponse; its data property is object.

示例

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

响应类型

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

Data 字段

类型	SDK 约定
`object`	SDK 未定义成员或键。

频率限制

基础额度：每分钟 60 次。