选股器

功能说明

执行选股器筛选。

方法签名

func (c *QuoteClient) MarketScanner(req model.MarketScannerRequest) (*model.ScannerResult, error)

参数

model.MarketScannerRequest

参数	类型	必填	默认值	说明
`Market`	`string`	是	始终序列化	无；可选值：ALL, US, HK, CN, SG
`Page`	`int`	否	空值省略	页码
`PageSize`	`int`	否	空值省略	每页数量
`CursorID`	`string`	否	空值省略	上一页返回的游标
`BaseFilterList`	`[]map[string]interface{}`	否	空值省略	基础指标筛选器
`AccumulateFilterList`	`[]map[string]interface{}`	否	空值省略	累计指标筛选器
`FinancialFilterList`	`[]map[string]interface{}`	否	空值省略	财务指标筛选器
`MultiTagsFilterList`	`[]map[string]interface{}`	否	空值省略	多标签筛选器
`SortFieldData`	`map[string]interface{}`	否	空值省略	排序字段配置
`MultiTagsFields`	`[]string`	否	空值省略	要返回的多标签字段

(*model.ScannerResult, error)。关键字段来自 model.ScannerResult：

字段	类型	JSON 字段
`Page`	`int`	`page`
`TotalPage`	`int`	`totalPage`
`TotalCount`	`int`	`totalCount`
`PageSize`	`int`	`pageSize`
`CursorID`	`string`	`cursorId`
`Items`	`[]ScannerResultItem`	`items`

`ScannerResultItem` 字段	类型	JSON 字段
`Symbol`	`string`	`symbol`
`Market`	`string`	`market`
`BaseDataList`	`[]ScannerDataRow`	`baseDataList`
`AccumulateDataList`	`[]ScannerDataRow`	`accumulateDataList`
`FinancialDataList`	`[]ScannerDataRow`	`financialDataList`
`MultiTagDataList`	`[]ScannerDataRow`	`multiTagDataList`

`ScannerDataRow` 字段	类型	JSON 字段
`Index`	`int`	`index`
`Name`	`string`	`name`
`Value`	`string`	`value`
`Data`	`float64`	`data`

示例

result, err := qc.MarketScanner(model.MarketScannerRequest{
	Market: "US",
	Page: 1,
	PageSize: 20,
	MultiTagsFields: []string{"MultiTagField_Industry"},
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

{"page":0,"totalPage":1,"totalCount":1,"pageSize":20,"cursorId":"next-cursor","items":[{"symbol":"NVDA","market":"US","baseDataList":[{"index":1,"name":"latestPrice","value":"132.15","data":132.15}],"accumulateDataList":[],"financialDataList":[],"multiTagDataList":[]}]}

调用频率

基础限流为 10 次/分钟。

获取选股器标签

功能说明

扫描器可用标签。

方法签名

func (c *QuoteClient) GetMarketScannerTags(req model.MarketScannerTagsRequest) ([]model.MarketScannerTagGroup, error)

参数

model.MarketScannerTagsRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`MultiTagsFields`	`[]string`	是	空值省略	要查询的多标签字段；JSON 字段为 `multi_tag_field_list`
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.MarketScannerTagGroup, error)。返回数组中每项表示一个市场与标签字段组合：

字段	类型	JSON 字段
`Market`	`string`	`market`
`MultiTagField`	`string`	`multiTagField`
`TagList`	`[]MarketScannerTag`	`tagList`

`MarketScannerTag` 字段	类型	JSON 字段
`Field`	`string`	`field`
`Name`	`string`	`name`
`Values`	`[]string`	`values`

当前 API 响应可能不会填充 MarketScannerTag 字段，此时字段保持零值；该方法不提供原始标签元素。

示例

result, err := qc.GetMarketScannerTags(model.MarketScannerTagsRequest{
	Market: "US",
	MultiTagsFields: []string{"MultiTagField_Industry"},
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

调用频率

基础限流为 10 次/分钟。