标的检索与目录

元信息域，承载跨市场标的检索与代码表浏览。 响应是完整标的信息（thscode / ticker / name / exchange / asset_type / currency）， 所有接口均返回统一响应信封 ApiResponse。

通用约定

• Base URL：https://fuyao.aicubes.cn。
• 必需请求头：X-api-key，缺失或无效返回 code=2001。
• 时间戳字段统一为毫秒级 Unix 时间戳。

标的检索

GET /api/meta/tickers/search

MCP Tool：get_meta_tickers_search

按关键词（thscode / ticker / 中英文名称）跨市场消歧，支持子串匹配。

请求参数

参数	位置	类型	必需	说明	默认值
q	query	string	是	搜索关键词：完整 thscode、ticker 代码或中英文名称（支持子串匹配）。	-
exchange	query	string	否	交易所过滤：SH(沪市) / SZ(深市) / BJ(北交所)。	-
asset_type	query	string	否	资产类别过滤：a-share(A 股) / a-share-index(A 股指数)。	-
limit	query	integer	否	返回上限，最大 50。	10

请求示例

# 按名称模糊搜索
curl 'https://fuyao.aicubes.cn/api/meta/tickers/search?q=%E5%B9%B3%E5%AE%89&limit=20' \
  -H 'X-api-key: <your-api-key>'

# 按 thscode 精确解析
curl 'https://fuyao.aicubes.cn/api/meta/tickers/search?q=600519.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "c3d4e5f6",
  "data": {
    "timestamp": 1716105600000,
    "item": [
      {
        "thscode": "601318.SH",
        "ticker": "601318",
        "name": "中国平安",
        "exchange": "SH",
        "asset_type": "a-share",
        "currency": "CNY"
      }
    ]
  }
}

标的目录

GET /api/meta/tickers/list

MCP Tool：get_meta_tickers_list

批量获取代码表，支持按交易所/资产类别过滤。采用 offset/limit 分页， 调用方循环递增 offset 直到 item.length < limit 即可取尽。

请求参数

参数	位置	类型	必需	说明	默认值
exchange	query	string	否	逗号分隔的交易所列表，SH / SZ / BJ，可多选。	SH,SZ
asset_type	query	string	否	资产类别：a-share / a-share-index。	a-share
limit	query	integer	否	单页条数，最大 10000。	1000
offset	query	integer	否	分页偏移。	0

请求示例

# 拉取全部沪深 A 股
curl 'https://fuyao.aicubes.cn/api/meta/tickers/list?exchange=SH,SZ&asset_type=a-share&limit=1000&offset=0' \
  -H 'X-api-key: <your-api-key>'

# 拉取 A 股指数
curl 'https://fuyao.aicubes.cn/api/meta/tickers/list?asset_type=a-share-index&limit=500' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "f7g8h9i0",
  "data": {
    "timestamp": 1716105600000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "name": "贵州茅台",
        "exchange": "SH",
        "asset_type": "a-share",
        "currency": "CNY"
      }
    ]
  }
}

响应字段

search 与 list 共用 data 结构：

字段	类型	说明
timestamp	long	数据就绪时间（毫秒），为当前代码表快照的上游加载时间。
item	array	标的列表。

item[] 为 TickerItem：

字段	类型	说明
thscode	string	完整 thscode，如 600519.SH。
ticker	string	纯代码，如 600519。
name	string	展示名称。
exchange	string	交易所后缀（SH / SZ / BJ），无后缀指数为 null。
asset_type	string	对外资产类别（a-share / a-share-index）。
currency	string	币种代码，A 股恒为 CNY。