跳到主要内容

期货合约扩展资料

期货合约扩展资料提供品种板块、主连、主力、次主力和商品指数等客户端内能力

该能力暂未开放外部接入相关数据能力将在后续版本接入同花顺AI客户端，当前版本暂不可使用本项目数据，敬请期待。
前往同花顺AI客户端 ↗
通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 本页接口结构用于说明计划接入同花顺AI客户端的数据契约，当前不作为外部接入入口。
  • 接口返回统一 ApiResponse 信封；ISO 日期按 Asia/Shanghai 解释，Unix 时间戳为毫秒。
  • 期货合约使用完整 thscode，品种列表每次最多 5 项；金融数值与日期可为 null，合法无数据返回空数组。

期货品种板块​

GET /api/futures/variety-plates/list

请求参数​

无业务参数。

参数类型必需默认值说明
————无业务参数。

请求示例​

以下命令仅展示接口路径与参数格式，当前不可用于外部调用。

curl 'https://fuyao.aicubes.cn/api/futures/variety-plates/list'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "variety_code": "CU",
        "name": "沪铜",
        "plate_level": 1,
        "plate_name": "有色金属"
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
item[]array品种板块列表；每项含可空的 variety_code、name、plate_level、plate_name。

期货主连资料​

GET /api/futures/contracts/main-continuous-list

请求参数​

无业务参数。

参数类型必需默认值说明
————无业务参数。

请求示例​

以下命令仅展示接口路径与参数格式，当前不可用于外部调用。

curl 'https://fuyao.aicubes.cn/api/futures/contracts/main-continuous-list'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "thscode": "CU.L8",
        "ticker": "CU",
        "name": "沪铜主连",
        "variety_code": "CU",
        "variety_name": "沪铜",
        "exchange_code": "SHFE",
        "minute_visit_count": 1200,
        "kline_visit_count": 300,
        "statistics_date": "2026-09-10"
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
item[]array主连列表。
thscode / ticker / name / variety_code / variety_name / exchange_codestring | null主连代码、名称、品种与交易所信息。
minute_visit_count / kline_visit_countinteger | null分时与 K 线访问次数。
statistics_datestring | null统计日期。

期货主力合约​

GET /api/futures/contracts/main-list

请求参数​

无业务参数。

参数类型必需默认值说明
————无业务参数。

请求示例​

以下命令仅展示接口路径与参数格式，当前不可用于外部调用。

curl 'https://fuyao.aicubes.cn/api/futures/contracts/main-list'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "thscode": "CU2601.SHF",
        "ticker": "CU2601",
        "name": "沪铜2601",
        "variety_code": "CU",
        "variety_name": "沪铜",
        "exchange_code": "SHFE",
        "list_date": "2025-01-01",
        "end_date": "2026-01-15",
        "last_trade_date": "2026-01-15",
        "last_delivery_date": "2026-01-20",
        "margin_rate": 0.12,
        "transaction_fee": null,
        "transaction_fee_rate": null
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
item[]array主力合约列表。
thscode / ticker / name / variety_code / variety_name / exchange_codestring | null合约、品种与交易所信息。
list_date / end_date / last_trade_date / last_delivery_datestring | nullISO 日期。
margin_rate / transaction_fee / transaction_fee_ratenumber | null保证金率、手续费与手续费率。

期货次主力合约​

GET /api/futures/contracts/secondary-main-list

请求参数​

无业务参数。

参数类型必需默认值说明
————无业务参数。

请求示例​

以下命令仅展示接口路径与参数格式，当前不可用于外部调用。

curl 'https://fuyao.aicubes.cn/api/futures/contracts/secondary-main-list'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": []
  }
}

返回字段​

字段结构与期货主力合约一致；合法无数据返回空数组。

期货商品指数资料​

GET /api/futures/contracts/commodity-index-list

请求参数​

无业务参数。

参数类型必需默认值说明
————无业务参数。

请求示例​

以下命令仅展示接口路径与参数格式，当前不可用于外部调用。

curl 'https://fuyao.aicubes.cn/api/futures/contracts/commodity-index-list'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "thscode": "CUFI.WI",
        "ticker": "CUFI",
        "name": "沪铜指数",
        "list_date": "2010-01-01",
        "end_date": null
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
item[]array商品指数列表；每项含可空的 thscode、ticker、name、list_date、end_date。