跳到主要内容

标的检索

元信息域的标的检索接口，用于按关键词（thscode / ticker / 中英文名称）跨市场消歧， 返回完整标的信息及可用的上市、到期、最后交易和最后交割日期。 所有接口均返回统一响应信封 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 / 中英文名称）跨市场消歧，支持子串匹配。

请求参数​

参数位置类型必需说明默认值
qquerystring是搜索关键词：完整 thscode、ticker 代码或中英文名称（支持子串匹配）。-
exchangequerystring否交易所过滤；支持证券交易所与 CFFEX、SHFE、INE、DCE、CZCE、GFEX、SSE、SZSE。-
asset_typequerystring否规范化资产类型，支持单值或逗号分隔多值；完整枚举见下方。-
limitqueryinteger否返回上限，最大 50。10

asset_type 可选值：a-share、a-share-index、fund-otc、fund-etf、 fund-lof、fund-reits、forex、futures、futures-commodity-index、options。传入任一非法值返回 code=1003。

asset_type含义
a-shareA 股股票
a-share-indexA 股指数、同花顺指数或板块
fund-otc场外公募基金
fund-etfETF 基金
fund-lofLOF 基金
fund-reits公募 REITs
forex外汇
futures期货
futures-commodity-index期货商品指数合约
options期权

请求示例​

# 按名称模糊搜索
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>'

# 检索 ETF
curl 'https://fuyao.aicubes.cn/api/meta/tickers/search?q=510300&asset_type=fund-etf' \
  -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",
        "list_date": "2007-03-01",
        "end_date": null,
        "last_trade_date": null,
        "last_delivery_date": null
      }
    ]
  }
}

响应字段​

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

item[] 为 TickerItem：

字段类型说明
thscodestring完整 thscode，如 600519.SH。
tickerstring纯代码，如 600519。
namestring展示名称。
exchangestring | null交易所后缀（SH / SZ / BJ）；场外基金为 null，.OF 不是交易所。
asset_typestring规范化资产类型；每条记录仅返回一个叶子类型，含义同请求参数枚举表。
currencystring币种代码；当前基金统一为 CNY。
list_datestring | null上市日期，格式 yyyy-MM-dd。
end_datestring | null合约到期日，格式 yyyy-MM-dd。
last_trade_datestring | null最后交易日，格式 yyyy-MM-dd。
last_delivery_datestring | null最后交割日，格式 yyyy-MM-dd。