股票搜索建议¶

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Search.md

所属接口集：股票搜索

请求 URL¶

GET /v1/api/search/suggest

认证方式¶

Bearer Token（详见认证与签名）

接口概述¶

根据关键词提供股票搜索建议，返回带展示文本的结果列表。支持按代码或名称搜索，名称搜索使用包含匹配（icontains）。

请求参数¶

参数	类型	必填	说明
q	string	是	搜索关键词
limit	int	否	返回数量上限，默认 10，范围 1-50
type	string	否	强制搜索类型：`code` 按代码搜索，`name` 按名称搜索。不传则自动判断
market	string	否	限定市场，逗号分隔，如 `SH,SZ`。可选值：`SH`、`SZ`、`BJ`

接口说明¶

自动判断逻辑：若 type 为 code 或 name 则强制使用对应模式
未指定 type 时，若输入为数字格式则按代码前缀匹配，否则按名称包含匹配
每条结果包含 display 字段，格式为 ts_code + 空格 + name，便于前端下拉展示

响应格式示例¶

{
  "data": [
    {
      "display": "600519.SH 贵州茅台",
      "code6": "600519",
      "ts_code": "600519.SH",
      "name": "贵州茅台",
      "market": "SH"
    }
  ]
}

返回状态¶

状态码	说明
200	成功
401	未认证
403	无权限