选股器

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

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

选股器

操作名

QuoteApiService.MARKET_SCANNER = market_scanner。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<MarketScannerResponse>

ModelValue: MarketScannerModel.

参数

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
`BaseFilterList`	列表，元素为 BaseFilter	`base_filter_list`	null	Optional	—
`AccumulateFilterList`	列表，元素为 AccumulateFilter	`accumulate_filter_list`	null	Optional	—
`FinancialFilterList`	列表，元素为 FinancialFilter	`financial_filter_list`	null	Optional	—
`MultiTagsFilterList`	列表，元素为 MultiTagsRelationFilter	`multi_tags_filter_list`	null	Optional	—
`SortFieldData`	SortFieldData	`sort_field_data`	CLR 默认值；序列化时省略	Optional	—
`Page`	int	`page`	CLR 默认值；序列化时省略	Optional	Positive integer
`PageSize`	int	`page_size`	CLR 默认值；序列化时省略	Optional	Positive integer

MarketScannerResponse 继承 TigerResponse；其 Data 为 MarketScannerPageItem。

响应数据结构：MarketScannerPageItem。

字段	C# 类型	说明
`Page`	`int`	当前页码
`PageSize`	`int`	每页数量
`TotalPage`	`int`	总页数
`TotalCount`	`int`	总记录数
`Items`	`List<MarketScannerItem>`	筛选结果列表

Items 项：MarketScannerItem

字段	C# 类型	说明
`Market`	`string`	所属市场
`Symbol`	`string`	证券代码
`BaseDataList`	`List<MarketIndicatorValue>`	基础指标列表
`AccumulateDataList`	`List<MarketIndicatorValue>`	累计指标列表
`FinancialDataList`	`List<MarketIndicatorValue>`	财务指标列表
`MultiTagDataList`	`List<MarketIndicatorValue>`	多标签指标列表

指标项：MarketIndicatorValue

字段	C# 类型	说明
`Index`	`int`	指标序号
`Name`	`string`	指标名称
`Value`	`object`	动态指标值；具体类型和字段取决于所请求的筛选字段

示例

TigerRequest<MarketScannerResponse> request = new()
{
    ApiMethodName = QuoteApiService.MARKET_SCANNER,
    ModelValue = new MarketScannerModel { Market = Market.US, Page = 1, PageSize = 20 }
};
MarketScannerResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "items": [
      {"symbol": "AAPL", "latestPrice": 308.91, "changeRate": -0.0735, "volume": 176739024, "marketValue": 3250000000000.0},
      {"symbol": "TSLA", "latestPrice": 285.50, "changeRate": 0.0312, "volume": 95000000, "marketValue": 915000000000.0}
    ],
    "totalCount": 156
  }
}

频率限制

基础额度：每分钟 10 次。

选股器标签

操作名

QuoteApiService.MARKET_SCANNER_TAGS = market_scanner_tags。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<MarketScannerTagsResponse>

ModelValue: MarketScannerTagsModel.

参数

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
`MultiTagFieldList`	列表，元素为 string	`multi_tag_field_list`	null	Optional	—

MarketScannerTagsResponse 继承 TigerResponse；其 Data 为 List<MarketScannerTagItem>。

响应数据结构：List<MarketScannerTagItem>。

字段	C# 类型	说明
`Market`	`string`	所属市场
`MultiTagField`	`string`	多标签筛选字段
`TagList`	`List<TagValue>`	可用标签列表

TagList 项：TagValue

字段	C# 类型	说明
`Tag`	`string`	标签名称
`Value`	`string?`	标签值

示例

TigerRequest<MarketScannerTagsResponse> request = new()
{
    ApiMethodName = QuoteApiService.MARKET_SCANNER_TAGS,
    ModelValue = new MarketScannerTagsModel { Market = Market.US }
};
MarketScannerTagsResponse? response = await quoteClient.ExecuteAsync(request);

响应类型

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

频率限制

基础额度：每分钟 10 次。