跳到主要内容

期货基差

期货基差提供主连合约最新基差快照与指定区间历史数据。

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

期货主连最新基差​

GET /api/futures/basis/main-continuous-latest

MCP Tool：get_futures_basis_main_continuous_latest

请求参数​

无业务参数。

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

请求示例​

curl 'https://fuyao.aicubes.cn/api/futures/basis/main-continuous-latest' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "thscode": "CU.L8",
        "ticker": "CU",
        "name": "沪铜主连",
        "variety_name": "沪铜",
        "reference_site": null,
        "updated_at": "2026-09-10 15:00:00",
        "spot_publish_date": "2026-09-10",
        "spot_indicator_id": null,
        "spot_price": 78000,
        "converted_spot_price": 78000,
        "close_price": 78200,
        "settle_price": 77900,
        "close_basis": 200,
        "settle_basis": -100,
        "close_basis_rate": 0.0026,
        "settle_basis_rate": -0.0013,
        "default_value": null,
        "average_close_basis": null,
        "average_settle_basis": null
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
thscode / ticker / name / variety_namestring | null主连代码与名称信息。
reference_site / updated_at / spot_publish_date / spot_indicator_id / default_valuestring | null参考来源、更新时间、现货发布日期、指标 ID 与默认口径原值。
spot_price / converted_spot_price / close_price / settle_pricenumber | null现货、折算现货、收盘与结算价格。
close_basis / settle_basis / close_basis_rate / settle_basis_ratenumber | null收盘/结算基差及其比例。
average_close_basis / average_settle_basisnumber | null平均收盘与结算基差。

期货历史基差​

GET /api/futures/basis/historical

MCP Tool：get_futures_basis_historical

请求参数​

参数类型必需默认值说明
thscodestring是—期货合约完整同花顺代码。
spot_indicator_idstring否—可选现货指标 ID；省略时使用上游默认口径。

请求示例​

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

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "date": "2026-09-10",
        "spot_price": 78000,
        "converted_spot_price": 78000,
        "close_price": 78200,
        "settle_price": 77900,
        "close_basis": 200,
        "settle_basis": -100,
        "close_basis_rate": 0.0026,
        "settle_basis_rate": -0.0013
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间。
item[].datestring | null记录日期。
item[].spot_price / converted_spot_price / close_price / settle_pricenumber | null现货、折算现货、收盘与结算价格。
item[].close_basis / settle_basis / close_basis_rate / settle_basis_ratenumber | null收盘/结算基差及其比例。