证券列表

获取全市场证券列表, 支持名称模糊或代码精确检索

门槛注册即用（免费版可用）

数据与交易所每日在市清单同步; 已剔除退市/停牌异常

限制分页, 每页≤100

接口说明

全市场证券清单(沪深北股票/ETF/可转债/指数)，支持代码与名称模糊搜索、分页。

构建本地证券字典、做搜索联想用它

清单与交易所每日在市名单同步，退市/停牌异常已剔除

快速调用

同一调用的三种等价写法，按接入习惯任选其一，复制即可运行。

名称搜索

import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.stock_list(name="平安", page=1, page_size=50)

名称搜索

import requests

API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"

r = requests.get(f"{API}/a/stock/list",
                 headers={"X-API-Key": KEY},
                 params={"name": "平安", "page": 1, "page_size": 50},
                 timeout=30)
r.raise_for_status()
data = r.json()["data"]   # 信封解包, 本接口数据在 data["list"]

名称搜索

curl -H "X-API-Key: sk-xxxxxxxxxxxx" \
  "https://api.369.top/api/a/stock/list?name=%E5%B9%B3%E5%AE%89&page=1&page_size=50"

输入参数

名称	类型	必选	描述
name	str	False	股票名称(模糊匹配); 与code二选一
code	str	False	股票代码, 四种写法都认(sz000001/000001/sz.000001/000001.SZ)
page	int	False	页码, 默认1
page_size	int	False	每页数量, 默认20, ≤100

返回字段

名称	类型	描述
list[]	array	{code(裸码), name, market, type}
total / page / page_size	int	总数与分页信息

返回数据样例

{
  "list": [
    {
      "code": "000001",
      "name": "上证指数",
      "market": "sh",
      "type": "指数"
    },
    {
      "code": "000001",
      "name": "平安银行",
      "market": "sz",
      "type": "股票"
    },
    {
      "code": "000002",
      "name": "Ａ股指数",
      "market": "sh",
      "type": "指数"
    }
  ],
  "total": 9129,
  "page": 1,
  "page_size": 3
}

最佳实践：检索二选一(name模糊/code精确, 互斥400护栏); total 在 df.attrs; 全市场全量用 stock_list_all(约92页, 建议本地缓存复用)。

认证方式、代码规范、错误码等通用约定见文档首页；可在在线测试中直接调试本接口。