指数列表

公开接口

指数行情 Index · 指数列表

分页读取平台的指数清单。清单由定时任务每天从 Tushare 全量同步入库，覆盖上交所（SSE）、深交所（SZSE）、中证（CSI）、申万（SW）四个市场，含规模 / 行业 / 主题 / 策略 / 债券等分类。可按市场、分类过滤，也可用关键词筛选。

接口地址

GET /cn/index/list

完整地址：https://api.databull.cn/cn/index/list

接口说明

分页读取平台的指数清单。清单由定时任务每天从 Tushare 全量同步入库，覆盖上交所（SSE）、深交所（SZSE）、中证（CSI）、申万（SW）四个市场的全部指数（约 10604 只，含规模 / 行业 / 主题 / 策略 / 债券等分类）。

可按 market、category 过滤，按 keyword 关键词筛选，结果按指数代码升序分页返回。

只需要「联想搜索」时用 /cn/index/search：它按相关度排序，更适合输入框实时提示。

请求参数

参数位置类型必填默认说明

market查询string否市场过滤：SSE 上交所 / SZSE 深交所 / CSI 中证 / SW 申万；留空表示不限

category查询string否分类过滤，如规模指数 / 行业指数 / 主题指数 / 策略指数；须与库中取值完全一致，留空表示不限

keyword查询string否关键词，同时匹配指数名称、裸码与全码，如沪深300 / 000300；留空表示不限

page查询integer否1页码，从 1 开始；不小于 1

page_size查询integer否100每页条数，1~500；取值 1~500

返回字段

字段类型说明

codenumber业务状态码，0 表示成功

dataobject分页结果对象

data.itemsarray指数记录数组，按指数代码升序

data.items[].index_codestring指数全码（Tushare ts_code），如 000300.SH；中证系列为 .CSI，申万系列为 .SI

data.items[].symbolstring裸代码，如 000300；查历史行情、成分股时用这个

data.items[].namestring指数名称，如沪深300

data.items[].marketstring市场：SSE 上交所 / SZSE 深交所 / CSI 中证 / SW 申万

data.items[].categorystring分类：规模指数 / 行业指数 / 主题指数 / 策略指数 / 债券指数等

data.items[].publisherstring指数发布方

data.items[].base_datestring基日，YYYY-MM-DD

data.items[].base_pointnumber基点

data.items[].list_datestring发布日期，YYYY-MM-DD

data.items[].constituent_countnumber已同步的成分股数量；0 表示尚未同步

data.items[].constituents_datestring成分股权重快照日，YYYY-MM-DD

data.totalnumber满足筛选条件的总条数

data.page / data.page_sizenumber当前页码 / 每页条数

data.has_moreboolean是否还有下一页

empty_reasonstring仅当 items 为空时出现，标注为空的原因（见下）

接口示例

cURL

curl "https://api.databull.cn/cn/index/list?market=CSI&category=规模指数" \
  -H "Authorization: Bearer $DATABULL_API_KEY"

Python

import requests

url = "https://api.databull.cn/cn/index/list"
params = {
    "market": "CSI",
    "category": "规模指数",
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())

响应示例

JSON

{
  "code": 0,
  "data": {
    "items": [
      {
        "index_code": "000300.SH",
        "symbol": "000300",
        "name": "沪深300",
        "market": "SSE",
        "category": "规模指数",
        "publisher": "中证指数有限公司、上海证券交易所",
        "base_date": "2004-12-31",
        "base_point": 1000.0,
        "list_date": "2005-04-08",
        "constituent_count": 300,
        "constituents_date": "2026-08-31"
      }
    ],
    "total": 10604,
    "page": 1,
    "page_size": 100,
    "has_more": true
  }
}

错误码

状态码触发条件

401缺少或无效 API 凭证

422分页参数越界（page < 1 或 page_size 超出 1~500）

说明

清单是全市场全量（约 10604 只，含 3505 只债券指数），浏览时建议用 market / category 收窄范围，或直接用指数搜索接口。
market 取值：SSE / SZSE / CSI / SW，大小写不敏感。
category 需与库中取值完全一致（区分大小写），常见值：规模指数、行业指数、主题指数、策略指数、风格指数、债券指数、综合指数。取值传错时不会报错，而是返回空列表并带 empty_reason: no_match。
keyword 同时匹配名称、裸码与全码；% 与 _ 会被转义，不会被当成通配符。
清单为空时（定时任务尚未跑过）返回 empty_reason: catalog_not_synced；有清单但筛选没命中时返回 no_match。