选股器

签名

async marketScanner(req: MarketScannerRequest): Promise<ScannerResult | undefined>

用途

按请求条件筛选证券。

参数、默认值与约束

参数	类型	必填	SDK 默认值	约束
`req`	`MarketScannerRequest`	是	无	—
`req.market`	`string`	是	无	—
`req.page`	`number \| undefined`	否	无	页码从 0 开始
`req.pageSize`	`number \| undefined`	否	无	省略或传 0 时每页最多返回 500 条
`req.cursorId`	`string \| undefined`	否	无	后续页使用上一页返回的游标
`req.baseFilterList`	`Record<string, unknown>[] \| undefined`	否	无	—
`req.accumulateFilterList`	`Record<string, unknown>[] \| undefined`	否	无	—
`req.financialFilterList`	`Record<string, unknown>[] \| undefined`	否	无	—
`req.multiTagsFilterList`	`Record<string, unknown>[] \| undefined`	否	无	—
`req.sortFieldData`	`Record<string, unknown> \| undefined`	否	无	提供时必须同时包含 `fieldType`、`fieldName` 和 `sortDir`
`req.multiTagsFields`	`string[] \| undefined`	否	无	—

Promise<ScannerResult | undefined>

字段	类型	说明
page	number	页码
totalPage	number	总页数
totalCount	number	总数量
pageSize	number	每页大小
cursorId	string	游标 ID
items	ScannerResultItem[]	数据数组

示例

const result = await quoteClient.marketScanner({ market: 'US' });
console.log(result);

返回示例

{
  "page": 0,
  "totalPage": 0,
  "totalCount": 0,
  "pageSize": 0,
  "cursorId": "string",
  "items": [
    {
      "symbol": "string",
      "market": "string",
      "baseDataList": [
        "ScannerDataRow"
      ],
      "accumulateDataList": [
        "ScannerDataRow"
      ],
      "financialDataList": [
        "ScannerDataRow"
      ],
      "multiTagDataList": [
        "ScannerDataRow"
      ]
    }
  ]
}

请求频率：基础上限为每分钟 10 次。

获取选股器标签

签名

async getMarketScannerTags(req: MarketScannerTagsRequest): Promise<MarketScannerTagGroup[]>

用途

查询 market scanner tags。

参数、默认值与约束

参数	类型	必填	SDK 默认值	约束
`req`	`MarketScannerTagsRequest`	是	无	—
`req.market`	`string \| undefined`	是	无	有效市场枚举值
`req.multiTagFieldList`	`string[] \| undefined`	是	无	非空；行业和概念字段返回可用标签，其他字段可能返回空列表
`req.lang`	`string \| undefined`	否	无	—

Promise<MarketScannerTagGroup[]>

字段	类型	说明
market	string	市场
multiTagField	string	多标签字段
tagList	MarketScannerTag[]	标签列表

示例

const result = await quoteClient.getMarketScannerTags({ market: 'US', multiTagFieldList: ['MultiTagField_Industry'] });
console.log(result);

返回示例

[
  {
    "market": "string",
    "multiTagField": "string",
    "tagList": [
      "MarketScannerTag"
    ]
  }
]

请求频率：基础上限为每分钟 10 次。