跳到主要内容

期货交易时间轴

期货交易时间轴提供合约最近交易日的交易阶段、交易所阶段与跨日时间范围。

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key。
  • 接口返回统一 ApiResponse 信封；ISO 日期按 Asia/Shanghai 解释，Unix 时间戳为毫秒。
  • 期货合约使用完整 thscode；金融数值与日期可为 null，合法无数据返回空数组。
GET /api/futures/calendar/session-timeline

MCP Tool：get_futures_calendar_session_timeline

请求参数​

参数类型必需默认值说明
thscodestring是—期货合约完整同花顺代码。

请求示例​

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

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "thscode": "CU2601.SHF",
    "trade_date": "2026-09-10",
    "timezone": "Asia/Shanghai",
    "trade_stages": [],
    "exchange_sessions": []
  }
}

返回字段​

字段类型说明
timestamp / thscode / trade_date / timezonelong / string数据时间、合约代码、最近交易日与时区。
trade_stages[]array交易阶段；每项含 trade_period 与 trade_ranges[]，范围含毫秒 begin_time、end_time。
exchange_sessions[]array交易所阶段；每项含 trade_phase 与 phase_range[]，范围结构同上。