窝轮牛熊证
轮证筛选器
对应的请求类：WarrantFilterRequest
说明
获取窝轮牛熊证行情列表数据，支持按不同字段排序和筛选轮证。
参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | string | Yes | 正股股票代码 |
| lang | Language | No | 返回名称的语言，默认使用客户端配置 |
| page | int | No | 页码，从 0 开始，默认为 0 |
| pageSize | Integer | No | 每页数量，默认 50 |
| sortFieldName | String | No | 排序字段（参照返回对象 WarrantItem 的字段）；仅设置 sortDir 时生效 |
| sortDir | SortDir | No | 排序顺序，枚举 SortDir_Ascend/SortDir_Descend；省略或使用 SortDir_No 时不设置排序 |
| warrantType | WarrantType... | No | 类型，可传多个枚举值：All、Call、Put、Bull、Bear。默认全部 |
| issuerName | String | No | 发行商（参照返回 FilterBounds 实例的 issuerName 字段），默认全部 |
| expireYM | String | No | 到期月份，格式为 yyyy-MM |
| state | WarrantState | No | 状态：All、Normal、TerminateTrades、WaitingToBeListed；默认 All |
| inOutPrice | OptionPrice... | No | 价内/价外筛选，可传多个枚举值：ITM（价内，包含平价）、OTM（价外） |
| lotSize | Set<Integer> | No | 每手股数 |
| entitlementRatio | Set<Double> | No | 换股比率 |
| strike | Double min, Double max | No | 行权价区间 |
| effectiveLeverage | Double min, Double max | No | 有效杠杆区间 |
| leverageRatio | Double min, Double max | No | 杠杆比例区间 |
| callPrice | Double min, Double max | No | 回收价区间 |
| volume | Long min, Long max | No | 成交量区间 |
| premium | Double min, Double max | No | 溢价区间 |
| outstandingRatio | Double min, Double max | No | 街货比区间 |
| impliedVolatility | Double min, Double max | No | 隐含波动率区间 |
返回
com.tigerbrokers.stock.openapi.client.https.response.option.WarrantFilterResponsesource
结构如下：
public class WarrantFilterResponse extends TigerResponse {
@JSONField(name = "data")
private WarrantFilterItem item;
}返回数据可通过WarrantFilterResponse.getItem()方法访问，返回WarrantFilterItem对象，其中com.tigerbrokers.stock.openapi.client.https.domain.option.item.WarrantFilterItem 属性如下:
| 名称 | 类型 | 说明 |
|---|---|---|
| page | int | 页码 |
| totalPage | int | 总页数 |
| totalCount | int | 数据总数 |
| bounds | FilterBounds | 请求可设置的过滤条件，说明见下文 |
| items | List<WarrantItem> | 列表，包含 WarrantItem 对象，轮证数据，说明见下文 |
FilterBounds对象结构：
| 名称 | 类型 | 说明 |
|---|---|---|
| issuerName | List<String> | 发行商名称 |
| expireDate | List<String> | 到期日 |
| lotSize | List<Integer> | 每手股数 |
| entitlementRatio | List<Double> | 换股比率 |
| leverageRatio | Range<Double> | 杠杆比率范围 |
| strike | Range<Double> | 行权价范围 |
| premium | Range<Double> | 溢价范围 |
| outstandingRatio | Range<Double> | 街货比范围 |
| impliedVolatility | Range<Double> | 隐含波动率范围 |
| effectiveLeverage | Range<Double> | 有效杠杆范围 |
| callPrice | Range<Double> | 回收价范围 |
WarrantItem对象结构：
| 名称 | 类型 | 说明 |
|---|---|---|
| symbol | string | 窝轮/牛熊证代码 |
| name | string | 标的名称 |
| type | WarrantType | 类型，1：认购，2：认沽，3：牛证，4：熊证 |
| secType | string | 合约类型，窝轮：WAR/牛熊证：IOPT |
| market | string | 市场，HK |
| entitlementRatio | Double | 换股比率 |
| entitlementPrice | Double | 换股价 |
| premium | Double | 溢价 |
| breakevenPoint | Double | 到期盈亏平衡点 |
| callPrice | Double | 回收价（仅牛熊证） |
| beforeCallLevel | Double | 距回收价（百分比，比如0.196875，含义为 19.6875%） |
| expireDate | string | 到期日，格式 yyyy-MM-dd |
| lastTradingDate | string | 最后交易日，格式 yyyy-MM-dd |
| state | WarrantState | 状态，1 正常, 2 终止交易, 3 等待上市 |
| changeRate | Double | 涨跌幅 |
| change | Double | 涨跌额 |
| latestPrice | Double | 最新价 |
| volume | Long | 成交量 |
| amount | Double | 成交额 |
| outstandingRatio | Double | 街货比 |
| lotSize | Integer | 每手股数 |
| strike | string | 行权价 |
| inOutPrice | Double | 价内（大于等于 0）/价外（小于 0） |
| delta | Double | 窝轮理论价值对标的价格变化的敏感度 |
| leverageRatio | Double | 杠杆比率 |
| effectiveLeverage | Double | 有效杠杆 |
| impliedVolatility | Double | 隐含波动率 |
具体字段可通过对象的 get 方法，如getSymbol()进行访问
注意：筛选结果 WarrantItem.lastTradingDate 是 yyyy-MM-dd 字符串；实时行情 WarrantQuote.lastTradingDate 是香港时间 0 点对应的毫秒时间戳。
SDK 使用 Java 包装类型表示这些数值字段。包装类型仅说明 Java 数据表示方式，本身不定义接口是否会省略字段或返回空值。
示例
WarrantFilterRequest request = WarrantFilterRequest.newRequest("00700");
request.lang(Language.zh_CN);
request.sortFieldName("expireDate");
request.sortDir(SortDir.SortDir_Descend);
request.warrantType(WarrantType.Bull);
request.issuerName("高盛");
request.strike(300.0, 320.0);
request.pageSize(10);
WarrantFilterResponse response = client.execute(request);
if (response.isSuccess()) {
System.out.println(JSONObject.toJSONString(response.getItem()));
} else {
System.out.println("response error:" + response.getMessage());
}返回示例
{
"code":0,
"data":{
"bounds":{
"callPrice":{
"max":520,
"min":113.96
},
"effectiveLeverage":{
"max":16.116,
"min":-14.076
},
"entitlementRatio":[
47.483,
92.166,
94.967,
100,
460.829,
474.834,
485.437,
500
],
"expireDate":[
"2026-01",
"2025-12",
"2025-08",
"2024-12",
"2024-08",
"2024-07",
"2024-06",
"2024-04",
"2024-03",
"2024-02",
"2024-01",
"2023-12",
"2023-11",
"2023-10",
"2023-09",
"2023-08",
"2023-07",
"2023-06",
"2023-05",
"2023-04",
"2023-03",
"2023-02"
],
"impliedVolatility":{
"max":344.093,
"min":0
},
"issuerName":[
"东亚",
"法巴",
"法兴",
"高盛",
"国君",
"海通",
"花旗",
"汇丰",
"麦银",
"摩利",
"摩通",
"瑞通",
"瑞信",
"瑞银",
"星展",
"中银"
],
"leverageRatio":{
"max":823.452604,
"min":1.372409
},
"lotSize":[
1000,
5000,
10000,
50000
],
"outstandingRatio":{
"max":1,
"min":0
},
"premium":{
"max":0.848338,
"min":-0.340153
},
"strike":{
"max":717.11,
"min":111.301
}
},
"items":[
{
"amount":391370,
"beforeCallLevel":0.221875,
"breakevenPoint":401.2,
"callPrice":320,
"change":0.033,
"changeRate":0.244444,
"entitlementPrice":84,
"entitlementRatio":500,
"expireDate":"2024-03-28",
"inOutPrice":0.232661,
"lastTradingDate":"2024-03-27",
"latestPrice":0.168,
"leverageRatio":4.654762,
"lotSize":5000,
"market":"HK",
"name":"腾讯高盛四三牛B.C",
"outstandingRatio":0.0023,
"premium":0.026087,
"secType":"IOPT",
"state":"Normal",
"strike":"317.2",
"symbol":"68723",
"type":"Bull",
"volume":2460000
},
{
"amount":341700,
"beforeCallLevel":0.26129,
"breakevenPoint":402.7,
"callPrice":310,
"change":0.035,
"changeRate":0.224359,
"entitlementPrice":95.5,
"entitlementRatio":500,
"expireDate":"2024-03-28",
"inOutPrice":0.272786,
"lastTradingDate":"2024-03-27",
"latestPrice":0.191,
"leverageRatio":4.094241,
"lotSize":5000,
"market":"HK",
"name":"腾讯高盛四三牛A.C",
"outstandingRatio":0.0111,
"premium":0.029923,
"secType":"IOPT",
"state":"Normal",
"strike":"307.2",
"symbol":"68722",
"type":"Bull",
"volume":1870000
}
],
"page":0,
"totalCount":2,
"totalPage":1
},
"message":"success",
"sign":"l8TsgnaHBThS1X3oQKyLAt+rKEqnY/bW4S/e2U0o5Zmvpr0NgcR86cbWXHSwr1eNIh9ffR0hPlE1j6cbZp2ClrUzDvBT/rIu+mSfIZDg7qTZ9I340VTlk1pIWQzc28Iickx+pzVd0k9tMsIF/hnoiBXfpiyywYa7pa/pLhIcHo8=",
"success":true,
"timestamp":1676522644671
}请求频率
基础限流为 60 次/分钟。
获取轮证行情
对应的请求类：WarrantQuoteRequest
说明
获取窝轮牛熊证实时行情。
参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbols | List<String> | Yes | 轮证标的代码，上限为 50 个 |
| lang | Language | No | 返回名称的语言，默认使用客户端配置 |
返回
com.tigerbrokers.stock.openapi.client.https.response.option.WarrantQuoteResponsesource
结构如下：
public class WarrantQuoteResponse extends TigerResponse {
@JSONField(name = "data")
private WarrantQuoteItem item;
}返回数据可通过WarrantQuoteResponse.getItem()方法访问，返回WarrantQuoteItem对象，其中 items 属性列表的com.tigerbrokers.stock.openapi.client.https.domain.option.item.WarrantQuote 属性如下:
| 字段 | 类型 | 说明 |
|---|---|---|
| symbol | String | 窝轮/牛熊证代码 |
| name | String | 窝轮/牛熊证名称 |
| exchange | String | 交易所 |
| market | String | 市场 |
| secType | String | 合约类型 |
| currency | String | 币种 |
| expiry | String | 到期日，格式 yyyy-MM-dd |
| strike | String | 行权价 |
| right | String | 方向 (PUT/CALL) |
| multiplier | Double | 每手数量 |
| lastTradingDate | Long | 最后交易日香港时间 0 点的毫秒时间戳 |
| entitlementRatio | Double | 换股比率 |
| entitlementPrice | Double | 换股价 |
| minTick | Double | 股价最小变动单位 |
| listingDate | Long | 上市日期香港时间 0 点的毫秒时间戳 |
| callPrice | Double | 回收价*（仅牛熊证）* |
| halted | HaltedStatus | 是否停牌。0: 正常 3: 停牌 4: 退市 |
| underlyingSymbol | String | 底层资产代码 |
| timestamp | Long | 时间戳 |
| latestPrice | Double | 最新价格 |
| preClose | Double | 前一交易日收盘价 |
| open | Double | 开盘价 |
| high | Double | 最高价 |
| low | Double | 最低价 |
| volume | Long | 成交量 |
| amount | Double | 成交额 |
| premium | Double | 溢价，小数形式，例如 0.02141 表示 2.141% |
| outstandingRatio | Double | 街货比，小数形式，例如 0.0019 表示 0.19% |
| impliedVolatility | Double | 隐含波动率（仅窝轮支持） |
| inOutPrice | Double | 带符号的价内/价外幅度，小数形式；大于等于 0 表示价内，小于 0 表示价外。例如 0.20744 表示价内 20.744%，-0.20744 表示价外 20.744% |
| delta | Double | 窝轮理论价值对标的价格变化的敏感度（仅窝轮支持） |
| leverageRatio | Double | 杠杆率 |
| breakevenPoint | Double | 到期盈亏平衡点 |
具体字段可通过对象的 get 方法，如getSymbol()进行访问
SDK 使用 Java 包装类型表示这些数值字段。包装类型仅说明 Java 数据表示方式，本身不定义接口是否会省略字段或返回空值；callPrice 仅适用于牛熊证，impliedVolatility 和 delta 仅适用于窝轮。
示例
List<String> symbols = new ArrayList<>();
symbols.add("68723");
symbols.add("68722");
WarrantQuoteRequest request = WarrantQuoteRequest.newRequest(symbols);
request.lang(Language.zh_CN);
WarrantQuoteResponse response = client.execute(request);
if (response.isSuccess()) {
System.out.println(JSONObject.toJSONString(response));
} else {
System.out.println("response error:" + response.getMessage());
}返回示例
{
"code":0,
"data":{
"items":[
{
"amount":391370,
"breakevenPoint":401.2,
"callPrice":320,
"currency":"HKD",
"entitlementPrice":84,
"entitlementRatio":500,
"exchange":"SEHK",
"expiry":"2024-03-28",
"halted":"Normal",
"high":0.171,
"inOutPrice":0.232661,
"lastTradingDate":1711468800000,
"latestPrice":0.168,
"leverageRatio":4.654762,
"listingDate":1673280000000,
"low":0.142,
"market":"HK",
"minTick":0.001,
"multiplier":5000,
"name":"腾讯高盛四三牛B.C",
"open":0.142,
"outstandingRatio":0.0023,
"preClose":0.135,
"premium":0.026087,
"right":"CALL",
"secType":"IOPT",
"strike":"317.2",
"symbol":"68723",
"timestamp":1676521860314,
"underlyingSymbol":"00700",
"volume":2460000
},
{
"amount":341700,
"breakevenPoint":402.7,
"callPrice":310,
"currency":"HKD",
"entitlementPrice":95.5,
"entitlementRatio":500,
"exchange":"SEHK",
"expiry":"2024-03-28",
"halted":"Normal",
"high":0.193,
"inOutPrice":0.272786,
"lastTradingDate":1711468800000,
"latestPrice":0.191,
"leverageRatio":4.094241,
"listingDate":1673280000000,
"low":0.172,
"market":"HK",
"minTick":0.001,
"multiplier":5000,
"name":"腾讯高盛四三牛A.C",
"open":0.172,
"outstandingRatio":0.0111,
"preClose":0.156,
"premium":0.029923,
"right":"CALL",
"secType":"IOPT",
"strike":"307.2",
"symbol":"68722",
"timestamp":1676521860314,
"underlyingSymbol":"00700",
"volume":1870000
}
]
},
"message":"success",
"sign":"af55ER5QJh0jv3iELe01l+Kfw/qt6DJTGOaLeMgJMgqZ/xWH+ELVfHEEscnTa4YkQE3DDJN78Nln7gUFIaMK9NeoC2JNgT3gUUiDEgHhaWmSGerEd56srOZiEC90yIEKSBn8sIrW2ZTs1c/8jyu9QBraxcWnnb4NoopOTL7hXXg=",
"success":true,
"timestamp":1676522864184
}请求频率
基础限流为 60 次/分钟。
Updated 5 days ago
Did this page help you?