Skip to content

组合期权询价 ​

POST /api/v1.0/quote/combo-option-quote

按调用方给出的组合腿(合约 + BUY/SELL + 数量)获取组合报价。side 必须由调用方传入,不会根据策略类型推断。 返回每组的 price / bid_price / ask_price / bid_volume / ask_volume / volume / turnover / last_close_price(价格和成交额均为实际金额),并回显 legs。 不返回 Greeks、IV、盈亏平衡点或 OHLC 数据。 支持美股和港股期权合约。美股备兑组合可包含一条标的正股腿(如 US.AAPL BUY 100)。港股不支持正股腿(担保策略),返回 -8。单个组合的错误通过 item.rsp_code 返回。 实时行情,需登录且该市场有实时权限。

请求参数 ​

参数类型位置必填说明
combo_liststring请求体是组合列表。每元素一套组合,腿在 legs[]。美股/港股期权合约;美股备兑可再带一条标的正股。港股不可带正股。一组最多一条正股腿,同组市场必须相同。

请求示例 ​

bash
curl -X POST 'https://webapi.futunn.com/api/v1.0/quote/combo-option-quote' -H 'Content-Type: application/json' -d '{"combo_list":[{"legs":[{"code":"US.AAPL261218C200000","side":"BUY","quantity":1}]}]}' | jq

响应字段 ​

参数类型说明
dataobject
data.quote_listobject[]
data.quote_list[].rsp_codeint单组询价结果码,0=成功
data.quote_list[].legsstring回显的请求腿(code / side / quantity)
data.quote_list[].pricenumber组合市价(实际价格)
data.quote_list[].bid_pricenumber买一价(实际价格)
data.quote_list[].ask_pricenumber卖一价(实际价格)
data.quote_list[].bid_volumeint买一量
data.quote_list[].ask_volumeint卖一量
data.quote_list[].volumeint组合成交量
data.quote_list[].turnovernumber组合成交额
data.quote_list[].last_close_pricenumber昨收价(实际价格)
paginationobject部分接口返回分页信息

错误码 ​

ret_codeerror.code说明
0—成功
-3invalid_parameter参数缺失或不在允许范围内
-7invalid_symbol标的在证券库中不存在
-8unsupported市场或品类不在本接口范围内
-9permission_denied已登录但没有对应行情权限
-10no_data当前没有可返回的数据
-11rate_limited调用过于频繁

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "quote_list": [
      {
        "rsp_code": 0,
        "legs": "example",
        "price": 2.5,
        "bid_price": 2.45,
        "ask_price": 2.55,
        "bid_volume": 10,
        "ask_volume": 12,
        "volume": 500,
        "turnover": 125000,
        "last_close_price": 2.4
      }
    ]
  }
}