工具方法

股票名称查询、代码→市场归属、关键词搜索等辅助功能。

工具类客户端方法集合，对应 /api/utility/* 端点。

get_stock_name(stock: str) -> str

获取股票的中文名称。

参数：

名称	类型	描述	默认
stock	str	股票代码，如 "000001.SZ"	必需

返回：

类型	描述
str	中文名称，如 "平安银行"

get_batch_stock_name(stocks: list[str]) -> dict[str, str]

批量获取股票的中文名称。

参数：

名称	类型	描述	默认
stocks	list[str]	股票代码列表	必需

返回：

类型	描述
dict[str, str]	以股票代码为键、中文名称为值的字典，
dict[str, str]	如 {"000001.SZ": "平安银行", "600519.SH": "贵州茅台"}

code_to_market(stock: str) -> dict

判断股票代码所属的市场。

根据股票代码的后缀（.SH/.SZ/.BJ 等）或编号规则，返回其所属市场信息。

参数：

名称	类型	描述	默认
stock	str	股票代码	必需

返回：

类型	描述
dict	市场信息字典

search_stocks(keyword: str, category: str = '沪深A股', limit: int = 20) -> list[str]

按关键字搜索股票。

支持按股票代码前缀或中文名称进行模糊搜索。

参数：

名称	类型	描述	默认
keyword	str	搜索关键字，如 "000001"、"平安"、"贵州"	必需
category	str	搜索范围（板块名），如 "沪深A股"	'沪深A股'
limit	int	最大返回条数	20

返回：

类型	描述
list[str]	匹配的股票代码列表