Stock Screener

All operations use QuoteClient.ExecuteAsync.

STOCK_DETAIL and QUOTE_OVERNIGHT require additional market-data entitlements. The server returns a permission error code when an entitlement is missing.

Market Scanner

Operation

QuoteApiService.MARKET_SCANNER = market_scanner. Use this constant for TigerRequest.ApiMethodName.

Request

TigerRequest<MarketScannerResponse>

ModelValue: MarketScannerModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR default; omitted during serializationno
Accountstring (nullable)accountnullNot applicableInherited field; QuoteClient does not inject TigerConfig.DefaultAccount, and null is omitted during serialization
MarketMarketmarketCLR default; omitted during serializationOptionalEnum value
BaseFilterListlist of BaseFilterbase_filter_listnullOptional
AccumulateFilterListlist of AccumulateFilteraccumulate_filter_listnullOptional
FinancialFilterListlist of FinancialFilterfinancial_filter_listnullOptional
MultiTagsFilterListlist of MultiTagsRelationFiltermulti_tags_filter_listnullOptional
SortFieldDataSortFieldDatasort_field_dataCLR default; omitted during serializationOptional
PageintpageCLR default; omitted during serializationOptionalPositive integer
PageSizeintpage_sizeCLR default; omitted during serializationOptionalPositive integer

Return

MarketScannerResponse inherits TigerResponse; its Data is MarketScannerPageItem.

Response data structure: MarketScannerPageItem; Items is List<MarketScannerItem>.

MarketScannerPageItem fields

FieldC# typeDescription
PageintCurrent page.
PageSizeintPage size.
TotalPageintTotal pages.
TotalCountintTotal result count.
ItemsList<MarketScannerItem>Scanner result items.

Nested MarketScannerItem fields

FieldC# typeDescription
MarketstringMarket identifier.
SymbolstringInstrument symbol.
BaseDataListList<MarketIndicatorValue>Basic indicator values.
AccumulateDataListList<MarketIndicatorValue>Accumulative indicator values.
FinancialDataListList<MarketIndicatorValue>Financial indicator values.
MultiTagDataListList<MarketIndicatorValue>Multi-tag indicator values.

Nested MarketIndicatorValue fields

FieldC# typeDescription
IndexintIndicator index.
NamestringIndicator name.
ValueobjectDynamic indicator value; its type and fields depend on the selected filter field.

Example

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

Response type

MarketScannerPageItem? data = response?.Data; // null when response or data is absent

Response Example

{
  "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
  }
}

Rate limit

Base tier: 10 requests per minute.

Related APIs

See Requests, responses, and operations.

Scanner Tags

Operation

QuoteApiService.MARKET_SCANNER_TAGS = market_scanner_tags. Use this constant for TigerRequest.ApiMethodName.

Request

TigerRequest<MarketScannerTagsResponse>

ModelValue: MarketScannerTagsModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR default; omitted during serializationno
Accountstring (nullable)accountnullNot applicableInherited field; QuoteClient does not inject TigerConfig.DefaultAccount, and null is omitted during serialization
MarketMarketmarketCLR default; omitted during serializationOptionalEnum value
MultiTagFieldListlist of stringmulti_tag_field_listnullOptional

Return

MarketScannerTagsResponse inherits TigerResponse; its Data is List<MarketScannerTagItem>.

Response data structure: List<MarketScannerTagItem>; each TagList value is List<TagValue>.

MarketScannerTagItem fields

FieldC# typeDescription
MarketstringMarket identifier.
MultiTagFieldstringMulti-tag field name.
TagListList<TagValue>Tag values.

Nested TagValue fields

FieldC# typeDescription
TagstringTag label.
Valuestring?Tag value.

Example

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

Response type

List<MarketScannerTagItem>? data = response?.Data; // null when response or data is absent

Rate limit

Base tier: 10 requests per minute.


Did this page help you?