跳到主要内容

集合竞价数据

集合竞价接口返回统一 ApiResponse 信封。thscode 使用带交易所后缀的标准代码，时间戳均为毫秒级 Unix 时间戳。

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
  • 所有接口返回统一 ApiResponse 信封，业务结果通过 code 表达。
  • A 股标的使用带交易所后缀的完整 thscode；时间戳均为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。

A股集合竞价快照​

GET /api/a-share/auction/snapshot

MCP Tool：get_a_share_auction_snapshot

请求参数​

参数类型必需默认值说明
thscodesstring是—一个或多个 A 股 thscode，使用英文逗号分隔；单次请求当前最多 100 个，按分隔后的原始 token 数在去重前校验。服务端按请求顺序去重返回。
stageenum否finallive（实时阶段）或 final（终态）。

请求示例​

curl 'https://fuyao.aicubes.cn/api/a-share/auction/snapshot?thscodes=600519.SH,000001.SZ&stage=final' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "99f4d83804b54d1c90681add4505eca0",
  "data": {
    "timestamp": 1786689000000,
    "auction_phase": "final",
    "data_status": "ready",
    "total": 1,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "name": "贵州茅台",
        "auction_price": 1421.0,
        "auction_pct": 0.35,
        "auction_volume": 12600,
        "auction_amount": 17904600,
        "auction_unmatched": 800,
        "auction_turnover_pct": 0.01,
        "auction_yesterday_ratio_pct": 82.4,
        "auction_volume_ratio": 1.12,
        "pre_close_price": 1416.04,
        "open_price": 1421.0,
        "last_price": 1421.0,
        "float_market_cap": 1785000000000
      }
    ]
  }
}

返回字段​

字段类型说明
data.timestamplong接口响应组装时间，毫秒 Unix 时间戳；实时、终态、停牌及 not_ready 场景均会返回。上游竞价行情时间仅用于判断数据新鲜度。
data.auction_phasestring集合竞价阶段。
data.data_statusstring数据状态。
data.totalinteger返回标的数量。
data.itemarray集合竞价明细列表。

data.item[] 字段：

字段类型说明
thscode / ticker / namestring标准代码、纯代码与股票简称。
auction_price / auction_pctnumber竞价价格与竞价涨跌幅百分数原值。
auction_volume / auction_amount / auction_unmatchednumber竞价成交量、成交额与未匹配量。
auction_turnover_pct / auction_yesterday_ratio_pct / auction_volume_rationumber竞价换手率、相对昨日成交量比例与竞价量比。
pre_close_price / open_price / last_pricenumber前收盘价、开盘价与最新价。
float_market_capnumber流通市值。

短线风向标竞价基准​

GET /api/a-share/auction/short-term-benchmark

MCP Tool：get_a_share_auction_short_term_benchmark

请求参数​

参数类型必需默认值说明
datestring否上海时区当日查询日期，格式 yyyy-MM-dd；缺失或传入空字符串时使用 Asia/Shanghai 当日，显式指定非交易日时不自动回退。

请求示例​

curl 'https://fuyao.aicubes.cn/api/a-share/auction/short-term-benchmark?date=2026-08-14' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "4e2f1c8c38e54ff1be9be3d17533bef9",
  "data": {
    "timestamp": 1786690800000,
    "date": "2026-08-14",
    "date_ms": 1786636800000,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "name": "贵州茅台",
        "auction_pct": 0.35,
        "tags": [
          "高开",
          "放量"
        ]
      }
    ]
  }
}

返回字段​

data 字段：

字段类型说明
timestamplong接口响应组装时间，毫秒 Unix 时间戳。
datestring最终查询日期，格式 yyyy-MM-dd。
date_mslong最终查询日期在 Asia/Shanghai 当日零点的毫秒 Unix 时间戳。
itemarray短线风向标竞价基准明细。

data.item[] 字段：

字段类型说明
thscodestring完整 A 股 thscode。
tickerstring纯股票代码。
namestring股票简称。
auction_pctnumber集合竞价涨跌幅，百分数原值。
tagsarray短线风向标标签。

通用鉴权、响应信封与错误码参见 API 参考。