通用

以下操作均通过 QuoteClient.ExecuteAsync 调用。

STOCK_DETAIL 与 QUOTE_OVERNIGHT 需额外行情权限，未开通时服务端返回权限错误码。

获取市场状态

操作名

QuoteApiService.MARKET_STATE = market_state。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<MarketStateResponse>

ModelValue: QuoteMarketModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`PackageName`	PackageName	`package_name`	CLR 默认值；序列化时省略	Optional	—
`IncludeOTC`	Boolean	`include_otc`	CLR 默认值；序列化时省略	Optional	—

MarketStateResponse 继承 TigerResponse；其 Data 为 List<MarketState>。

响应数据类型：List<MarketState>。

字段	C# 类型	说明
`Market`	`string`	市场标识
`MarketStatus`	`string`	市场状态
`Status`	`string`	交易状态
`OpenTime`	`string`	开市时间

示例

TigerRequest<MarketStateResponse> request = new()
{
    ApiMethodName = QuoteApiService.MARKET_STATE,
    ModelValue = new QuoteMarketModel { Market = Market.US }
};
MarketStateResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<MarketState>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "market": "US",
      "marketStatus": "Pre-Mkt",
      "status": "PRE_HOUR_TRADING",
      "openTime": "08-03 09:30:00 EDT"
    }
  ]
}

频率限制

基础额度：每分钟 10 次。

获取股票代码列表

操作名

QuoteApiService.ALL_SYMBOLS = all_symbols。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<TigerListStringResponse>

ModelValue: QuoteMarketModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`PackageName`	PackageName	`package_name`	CLR 默认值；序列化时省略	Optional	—
`IncludeOTC`	Boolean	`include_otc`	CLR 默认值；序列化时省略	Optional	—

TigerListStringResponse 继承 TigerResponse；其 Data 为 List<string>。字符串元素不是对象模型，不存在字段表。

响应数据类型：List<string>。列表元素为字符串，不存在对象字段表。

示例

TigerRequest<TigerListStringResponse> request = new()
{
    ApiMethodName = QuoteApiService.ALL_SYMBOLS,
    ModelValue = new QuoteMarketModel { Market = Market.US }
};
TigerListStringResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": ["A", "AA", "AAL", "AAPL", "ABBV", "ABC", "ABNB"]
}

频率限制

基础额度：每分钟 10 次。

获取股票代码和名称列表

操作名

QuoteApiService.ALL_SYMBOL_NAMES = all_symbol_names。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<SymbolNameResponse>

ModelValue: QuoteMarketModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`PackageName`	PackageName	`package_name`	CLR 默认值；序列化时省略	Optional	—
`IncludeOTC`	Boolean	`include_otc`	CLR 默认值；序列化时省略	Optional	—

SymbolNameResponse 继承 TigerResponse；其 Data 为 List<SymbolNameItem>。

响应数据类型：List<SymbolNameItem>。

字段	C# 类型	说明
`Symbol`	`string`	证券代码
`Name`	`string`	证券名称

示例

TigerRequest<SymbolNameResponse> request = new()
{
    ApiMethodName = QuoteApiService.ALL_SYMBOL_NAMES,
    ModelValue = new QuoteMarketModel { Market = Market.US }
};
SymbolNameResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<SymbolNameItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"symbol": "00001", "name": "CKH Holdings"},
    {"symbol": "00700", "name": "TENCENT"}
  ]
}

频率限制

基础额度：每分钟 10 次。

获取交易日历

操作名

QuoteApiService.TRADING_CALENDAR = trading_calendar。该常量用于设置 TigerRequest.ApiMethodName。

服务端已注册此操作。

请求

TigerRequest<TradeCalendarResponse>

ModelValue: TradeCalendarModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`Market`	Market	`market`	CLR 默认值；序列化时省略	Optional	Enum value
`BeginDate`	string	`begin_date`	null	Optional	—
`EndDate`	string	`end_date`	null	Optional	Timestamp or date format; maintain chronological order

TradeCalendarResponse 继承 TigerResponse；其 Data 为 List<TradeCalendar>。

响应数据类型：List<TradeCalendar>。

字段	C# 类型	说明
`Date`	`string`	日期
`Type`	`string`	交易日类型

示例

TigerRequest<TradeCalendarResponse> request = new()
{
    ApiMethodName = QuoteApiService.TRADING_CALENDAR,
    ModelValue = new TradeCalendarModel { Market = Market.US, BeginDate = "2026-01-01", EndDate = "2026-01-31" }
};
TradeCalendarResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<TradeCalendar>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"date": "2025-07-28", "type": "TRADING"},
    {"date": "2025-07-29", "type": "TRADING"}
  ]
}

获取行情合约

操作名

QuoteApiService.QUOTE_CONTRACT = quote_contract。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<QuoteContractResponse>

ModelValue: QuoteContractsModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`Symbol`	string	`symbol`	null	Required	—
`SecType`	SecType	`sec_type`	CLR 默认值；序列化时省略	Optional	—
`Expiry`	string	`expiry`	null	Optional	—

QuoteContractResponse 继承 TigerResponse；其 Data 为 QuoteContractItem。

响应数据结构：QuoteContractItem。

字段	C# 类型	说明
`Symbol`	`string`	查询证券代码
`SecType`	`string`	证券类型
`Items`	`List<QuoteContract>`	合约列表

Items 项：QuoteContract

字段	C# 类型	说明
`Symbol`	`string`	证券代码
`Name`	`string`	名称
`Exchange`	`string`	交易所
`Market`	`string`	市场
`SecType`	`string`	证券类型
`Currency`	`string`	币种
`Expiry`	`string`	到期日
`Strike`	`string`	行权价
`Right`	`string`	期权方向
`Multiplier`	`double`	合约乘数

示例

TigerRequest<QuoteContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.QUOTE_CONTRACT,
    ModelValue = new QuoteContractsModel { Symbol = "AAPL", SecType = SecType.STK }
};
QuoteContractResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

频率限制

基础额度：每分钟 60 次。

获取行情权限

操作名

QuoteApiService.GET_QUOTE_PERMISSION = get_quote_permission。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<QuotePermissionResponse>

ModelValue: ApiModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略

QuotePermissionResponse 继承 TigerResponse；其 Data 为 List<QuotePermission>。

响应数据类型：List<QuotePermission>。

字段	C# 类型	说明
`Name`	`string`	权限名称
`ExpireAt`	`long`	权限到期时间戳

示例

TigerRequest<QuotePermissionResponse> request = new()
{
    ApiMethodName = QuoteApiService.GET_QUOTE_PERMISSION,
    ModelValue = new ApiModel()
};
QuotePermissionResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<QuotePermission>? data = response?.Data; // response 或 data 缺失时为 null

频率限制

基础额度：每分钟 10 次。

抢占行情设备访问权

操作名

QuoteApiService.GRAB_QUOTE_PERMISSION = grab_quote_permission。该常量用于设置 TigerRequest.ApiMethodName。

该操作将行情设备访问权切换到当前设备，不会购买或授予新的行情权限。

请求

TigerRequest<QuotePermissionResponse>

ModelValue: ApiModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略

QuotePermissionResponse 继承 TigerResponse；其 Data 为 List<QuotePermission>。

响应数据类型：List<QuotePermission>。

字段	C# 类型	说明
`Name`	`string`	权限名称
`ExpireAt`	`long`	权限到期时间戳

示例

TigerRequest<QuotePermissionResponse> request = new()
{
    ApiMethodName = QuoteApiService.GRAB_QUOTE_PERMISSION,
    ModelValue = new ApiModel()
};
QuotePermissionResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<QuotePermission>? data = response?.Data; // response 或 data 缺失时为 null

频率限制

基础额度：每分钟 10 次。

获取 K 线额度

操作名

QuoteApiService.KLINE_QUOTA = kline_quota。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<KlineQuotaResponse>

ModelValue: KlineQuotaModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略
`WithDetails`	Boolean	`with_details`	CLR 默认值；序列化时省略	Optional	—

KlineQuotaResponse 继承 TigerResponse；其 Data 为 List<QuotaItem>。

响应数据类型：List<QuotaItem>。

字段	C# 类型	说明
`Remain`	`int`	剩余额度
`Used`	`int`	已用额度
`Method`	`string`	对应操作名
`Details`	`List<string>`	额度明细

示例

TigerRequest<KlineQuotaResponse> request = new()
{
    ApiMethodName = QuoteApiService.KLINE_QUOTA,
    ModelValue = new KlineQuotaModel { WithDetails = true }
};
KlineQuotaResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

List<QuotaItem>? data = response?.Data; // response 或 data 缺失时为 null

频率限制

基础额度：每分钟 10 次。

获取用户牌照

操作名

QuoteApiService.USER_LICENSE = user_license。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<UserLicenseResponse>

ModelValue: ApiModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略

UserLicenseResponse 继承 TigerResponse；其 Data 为 UserLicense。

响应数据类型：UserLicense。

字段	C# 类型	说明
`License`	`string`	许可信息

示例

TigerRequest<UserLicenseResponse> request = new()
{
    ApiMethodName = QuoteApiService.USER_LICENSE,
    ModelValue = new ApiModel()
};
UserLicenseResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

频率限制

基础额度：每分钟 10 次。

刷新 Token

操作名

QuoteApiService.USER_TOKEN_REFRESH = user_token_refresh。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<UserTokenResponse>

ModelValue: ApiModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	CLR 默认值；序列化时省略	no	—
`Account`	string (nullable)	`account`	null	Not applicable	`Account` 是继承字段；`QuoteClient` 不会从 `TigerConfig.DefaultAccount` 注入，null 时序列化省略

UserTokenResponse 继承 TigerResponse；其 Data 为 UserToken。

响应数据类型：UserToken。

字段	C# 类型	说明
`TigerId`	`string`	用户标识
`License`	`string`	许可信息
`Token`	`string`	刷新后的令牌
`CreateTime`	`long`	创建时间戳
`ExpiredTime`	`long`	到期时间戳

示例

TigerRequest<UserTokenResponse> request = new()
{
    ApiMethodName = QuoteApiService.USER_TOKEN_REFRESH,
    ModelValue = new ApiModel()
};
UserTokenResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

频率限制

基础额度：每分钟 10 次。