同花顺指数列表和成分股

同花顺指数构成域，承载同花顺指数列表浏览与成分股清单获取。 典型调用顺序：先用 catalog 拿到目标指数的 thscode，再用 constituents 取成分股。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key，缺失或无效返回 code=2001。
• thscode 入参均会被 trim().toUpperCase() 标准化，不接受逗号，单次仅支持一个指数。

同花顺指数列表

GET /api/a-share-index/catalog/ths-index-list

MCP Tool：get_a_share_index_catalog_ths_index_list

按 tag（概念 / 区域 / 特色 / 行业）列出同花顺指数清单，单 tag 一次性全量返回， 无分页参数。

请求参数

参数	位置	类型	必需	说明	默认值
tag	query	string	否	标签白名单：cn_concept(A 股概念) / region(区域指数) / tszs(特色指数) / industry(行业指数)。大小写不敏感。	cn_concept

请求示例

# 拉取全部概念板块
curl 'https://fuyao.aicubes.cn/api/a-share-index/catalog/ths-index-list?tag=cn_concept' \
  -H 'X-api-key: <your-api-key>'

# 拉取全部同花顺行业指数
curl 'https://fuyao.aicubes.cn/api/a-share-index/catalog/ths-index-list?tag=industry' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "e5f6g7h8",
  "data": {
    "timestamp": 1748102400000,
    "item": [
      { "thscode": "886042.TI", "name": "白酒概念" },
      { "thscode": "886041.TI", "name": "新能源车" }
    ]
  }
}

响应字段

字段	类型	说明
timestamp	long	数据时间戳（毫秒）。
item[].thscode	string	同花顺指数的完整 thscode，如 886042.TI。
item[].name	string	同花顺指数展示名称。

指数维度不暴露纯代码 ticker。

同花顺指数成分股

GET /api/a-share-index/constituents/ths-stock-list

MCP Tool：get_a_share_index_constituents_ths_stock_list

按单个指数 thscode 返回当前成分股清单。 支持同花顺板块指数（如 886042.TI）与标准指数（如沪深 300 000300.SH / 399300.SZ）。

请求参数

参数	位置	类型	必需	说明	默认值
thscode	query	string	是	指数 thscode，形如 {ticker}.{suffix}。入参会被 trim().toUpperCase() 标准化；不接受逗号，单次仅支持一个指数。	-

请求示例

# 拉取某同花顺概念板块成分股
curl 'https://fuyao.aicubes.cn/api/a-share-index/constituents/ths-stock-list?thscode=886042.TI' \
  -H 'X-api-key: <your-api-key>'

# 拉取沪深 300 成分股
curl 'https://fuyao.aicubes.cn/api/a-share-index/constituents/ths-stock-list?thscode=000300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "f6g7h8i9",
  "data": {
    "timestamp": 1748102400000,
    "item": [
      { "thscode": "600519.SH", "ticker": "600519", "name": "贵州茅台" },
      { "thscode": "000858.SZ", "ticker": "000858", "name": "五粮液" }
    ]
  }
}

响应字段

字段	类型	说明
timestamp	long	数据时间戳（毫秒）。
item[].thscode	string	成分股完整 thscode。
item[].ticker	string	成分股纯代码。
item[].name	string	成分股展示名称。