跳到主要内容

期权基础资料

期权基础资料提供品种目录与单个合约的详细信息。

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

期权品种资料​

GET /api/options/varieties/list

MCP Tool：get_options_varieties_list

请求参数​

无业务参数。

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

请求示例​

curl 'https://fuyao.aicubes.cn/api/options/varieties/list' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "variety_code": "IO",
        "name": "沪深300股指期权",
        "exchange_code": "CFFEX",
        "exchange_name": "中国金融期货交易所",
        "has_night_session": false,
        "margin_rate": null,
        "trade_amount": 1200,
        "price_coefficient": 1,
        "price_unit": "点",
        "trade_unit": "手",
        "tick_size": 0.2,
        "contract_multiplier": 100,
        "transaction_fee": null,
        "exercise_fee": null,
        "settlement_type": "cash",
        "trade_sessions": []
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间，毫秒时间戳。
item[]array期权品种列表。
item[].variety_code / namestring | null品种代码与名称。
item[].exchange_code / exchange_namestring | null交易所代码与名称。
item[].has_night_sessionboolean | null是否包含夜盘。
item[].margin_rate / trade_amountnumber | null保证金率与成交额。
item[].price_coefficient / tick_size / contract_multipliernumber | null价格系数、最小变动价位与合约乘数。
item[].price_unit / trade_unitstring | null价格单位与交易单位。
item[].transaction_fee / exercise_feenumber | null交易手续费与行权手续费。
item[].settlement_typestring | null结算类型：physical 或 cash；未知值保留原始编码。
item[].trade_sessions[]array交易时段；每项含 start_time、end_time、session_type。

期权合约详情​

GET /api/options/contracts/detail

MCP Tool：get_options_contracts_detail

请求参数​

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

请求示例​

curl 'https://fuyao.aicubes.cn/api/options/contracts/detail?thscode=IO2601-C-4000.CFE' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "thscode": "IO2601-C-4000.CFE",
    "ticker": "IO2601-C-4000",
    "display_code": "IO2601-C-4000",
    "name": "沪深300股指期权",
    "variety_code": "IO",
    "pinyin": null,
    "list_date": "2026-01-01",
    "end_date": "2026-01-16",
    "last_trade_date": "2026-01-16",
    "last_delivery_date": "2026-01-16",
    "margin_rate": null,
    "underlying_code": "IF2601",
    "strike_price": 4000,
    "exercise_style": "european",
    "option_type": "call",
    "trade_amount": 1200
  }
}

返回字段​

字段类型说明
timestamplong数据时间，毫秒时间戳。
thscode / ticker / display_codestring | null完整代码、纯代码与展示代码。
name / variety_code / pinyinstring | null合约名称、品种代码与拼音。
list_date / end_date / last_trade_date / last_delivery_datestring | nullISO 日期；来源缺失时为 null。
margin_rate / strike_price / trade_amountnumber | null保证金率、行权价与成交额。
underlying_codestring | null上游标的代码，不保证为规范 thscode。
exercise_stylestring | null行权方式：bermudan、american 或 european。
option_typestring | null期权方向：call 或 put。