跳到主要内容

期货行情

期货行情提供合约分时和 K 线数据；端外访问分时仅支持当前交易日、K 线仅支持日 K，AI 客户端内可使用历史交易日和全部周期。

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
  • 期货合约与期货商品指数使用完整 thscode（例如 CU2601.SHF、850002.TI）；接口返回统一 ApiResponse 信封。
  • ISO 日期按 Asia/Shanghai 解释，Unix 时间戳为毫秒。金融数值与日期来源缺失时可为 null，合法无数据时返回 []。

期货分时​

GET /api/futures/prices/intraday

MCP Tool：get_futures_prices_intraday

请求参数​

参数类型必需默认值说明
thscodestring是—期货合约或期货商品指数完整同花顺代码。
sessionenum否—行情阶段：pre_market-盘前、intraday-盘中、post_market-盘后；省略时使用 intraday。
trade_datestring否—端外仅允许 0；AI 客户端内可传 0 或合法历史交易日 yyyyMMdd。

商品指数行情可直接传入对应 thscode，例如 850002.TI。

请求示例​

curl 'https://fuyao.aicubes.cn/api/futures/prices/intraday?thscode=CU2601.SHF&session=intraday' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1767922260000,
    "thscode": "CU2601.SHF",
    "date": "2026-01-09",
    "session": "intraday",
    "item": [
      {
        "timestamp": 1767922260000,
        "price": 78200,
        "volume": 12,
        "turnover": 4692000
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
thscode / date / sessionstring行情标的代码、当前或最近交易日与行情阶段。
item[]array分时点；每项含可空的 timestamp、price、volume、turnover。

期货K线​

GET /api/futures/prices/daily

MCP Tool：get_futures_prices_daily

请求参数​

参数类型必需默认值说明
thscodestring是—期货合约或期货商品指数完整同花顺代码。
startlong否—与 end 成对提供的正毫秒时间戳；两者均省略时查询最近 100 根。
endlong否—与 start 成对提供，且不早于 start。
time_periodenum否—端外仅允许 day_1；AI 客户端内可使用 min_1、min_10、hour_1、day_1、week_1、month_1、quarter_1、year_1。

商品指数 K 线同样使用对应 thscode，例如 850002.TI。

请求示例​

curl 'https://fuyao.aicubes.cn/api/futures/prices/daily?thscode=CU2601.SHF' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1767922260000,
    "thscode": "CU2601.SHF",
    "interval": "1d",
    "item": [
      {
        "timestamp": 1767888000000,
        "open_price": 78000,
        "high_price": 78400,
        "low_price": 77800,
        "close_price": 78200,
        "volume": 120000,
        "turnover": 46920000000
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
thscodestring期货合约或期货商品指数代码。
intervalstring实际返回的 K 线周期；端外调用固定为 day_1。
item[]array日 K；每项含可空的 timestamp、open_price、high_price、low_price、close_price、volume、turnover。