指数数据

指数数据域，承载同花顺指数列表浏览、成分股清单、指数行情快照与历史 K 线。 典型调用顺序：先用 catalog 或 meta 拿到目标指数的 thscode，再按场景取成分股、快照或历史 K 线。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key，缺失或无效返回 code=2001。
• thscode 入参均会被 trim().toUpperCase() 标准化，不接受逗号，单次仅支持一个指数。
• 指数行情覆盖上证交易所指数（如 000001.SH）、深证交易所指数（如 399001.SZ）、同花顺板块（如 886042.TI）与同花顺行业指数（如 881101.TI）。

同花顺指数列表

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	成分股展示名称。

指数行情快照

GET /api/a-share-index/prices/snapshot

MCP Tool：get_a_share_index_prices_snapshot

按 thscodes 批量获取指数最新行情。与 A 股行情快照不同，本接口必须传 thscodes， 不支持空入参枚举全指数；limit / offset 仅为签名对齐保留，对当前接口无效。

请求参数

参数	位置	类型	必需	说明	默认值
thscodes	query	string	是	逗号分隔的指数 thscode 列表，如 000001.SH,399001.SZ,886042.TI,881101.TI。	-
limit	query	integer	否	与 A 股行情快照签名对齐，对本接口无效。	-
offset	query	integer	否	与 A 股行情快照签名对齐，对本接口无效。	-

请求示例

curl 'https://fuyao.aicubes.cn/api/a-share-index/prices/snapshot?thscodes=000001.SH,399001.SZ,886042.TI,881101.TI' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "7e25804be878464ba420037155f041e6",
  "data": {
    "timestamp": 1784275991000,
    "total": 4,
    "item": [
      {
        "thscode": "000001.SH",
        "ticker": "000001",
        "last_price": 3388.06,
        "price_change": 12.21,
        "price_change_ratio_pct": 0.3617,
        "open_price": 3370.25,
        "high_price": 3392.18,
        "low_price": 3365.4,
        "prev_price": 3375.85,
        "volume": 321000000,
        "turnover": 420000000000
      }
    ]
  }
}

响应字段

data 为 SnapshotData，item[] 为 PriceSnapshotItem，字段结构与 A 股行情快照 一致。

指数历史 K 线

GET /api/a-share-index/prices/historical

MCP Tool：get_a_share_index_prices_historical

获取单只指数的历史 K 线序列。每次请求仅支持一个 thscode，只支持 start / end 时间区间模式， 窗口跨度不超过 10 年。指数无复权语义，因此没有 adjust 参数；本接口也没有 offset 参数。

请求参数

参数	位置	类型	必需	说明	默认值
thscode	query	string	是	单只指数 thscode，不接受逗号。	-
interval	query	string	是	K 线周期，当前仅支持 1d（日线）。	1d
start	query	long	是	起始时间，毫秒 Unix 时间戳。	-
end	query	long	是	结束时间，毫秒 Unix 时间戳。end - start 超过 10 年返回 code=1003。	-

请求示例

# 上证综指过去一年日线
curl 'https://fuyao.aicubes.cn/api/a-share-index/prices/historical?thscode=000001.SH&interval=1d&start=1716105600000&end=1747641600000' \
  -H 'X-api-key: <your-api-key>'

# 同花顺白酒概念
curl 'https://fuyao.aicubes.cn/api/a-share-index/prices/historical?thscode=886042.TI&interval=1d&start=1716105600000&end=1747641600000' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "b9f91af9c77a42d6b8a04738793d2fa2",
  "data": {
    "timestamp": 1747584000000,
    "adjust": null,
    "item": [
      {
        "date_ms": 1716134400000,
        "open_price": 3108.22,
        "high_price": 3125.74,
        "low_price": 3101.15,
        "close_price": 3120.68,
        "volume": 281000000,
        "turnover": 360000000000
      }
    ]
  }
}

响应字段

data 为 HistoricalData，item[] 为 PriceBarItem，字段结构与 A 股历史 K 线 一致。指数接口响应中的 data.adjust 固定为 null。