跳到主要内容

期货品种资料

期货品种资料提供期货品种目录及交易属性。

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
  • 品种代码使用大写形式；接口返回统一 ApiResponse 信封。
  • Unix 时间戳均为毫秒；金融数值来源缺失时可为 null，列表无数据时返回 []。
GET /api/futures/varieties/list

MCP Tool：get_futures_varieties_list

请求参数​

无业务参数。

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

请求示例​

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

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "request-id",
  "data": {
    "timestamp": 1789036800000,
    "item": [
      {
        "variety_code": "CU",
        "quote_code": "CU",
        "name": "沪铜",
        "exchange_code": "SHFE",
        "exchange_name": "上海期货交易所",
        "has_night_session": true,
        "margin_rate": 0.12,
        "main_contract_thscode": "CU2601.SHF",
        "trade_amount": 5,
        "price_coefficient": 1,
        "price_unit": "元/吨",
        "trade_unit": "吨/手",
        "tick_size": 10,
        "contract_multiplier": 5,
        "capital_flow": null,
        "long_short_ratio": null,
        "transaction_fee": null,
        "transaction_fee_rate": null,
        "trade_sessions": []
      }
    ]
  }
}

返回字段​

字段类型说明
timestamplong数据时间，毫秒时间戳。
item[]array品种列表。
item[].variety_code / quote_code / namestring | null品种代码、行情代码与名称。
item[].exchange_code / exchange_namestring | null交易所代码与名称。
item[].has_night_sessionboolean | null是否包含夜盘。
item[].margin_rate / capital_flow / long_short_rationumber | null保证金率、资金流与多空比。
item[].trade_amountnumber | null品种交易单位数量，单位由 trade_unit 字段给出。
item[].price_coefficient / tick_size / contract_multipliernumber | null价格系数、最小变动价位与合约乘数。
item[].price_unit / trade_unit / main_contract_thscodestring | null价格单位、交易单位与主力合约代码。
item[].transaction_fee / transaction_fee_ratenumber | null手续费与手续费率。
item[].trade_sessions[]array交易时段；每项含 start_time、end_time、session_type。