窝轮牛熊证

C++ HTTP 方法返回响应中的 data 内容；get_warrant_filter() 和 get_warrant_real_time_quote() 还会进一步返回其中的 items。完整响应 JSON 的外层包装不属于方法返回值。

筛选窝轮和牛熊证

value QuoteClient::get_warrant_filter(const utility::string_t symbol, int page_size = 100, int page = 0, utility::string_t sort_field_name = U(""), utility::string_t sort_dir = U("SortDir_Ascend"))

说明

按正股查询窝轮和牛熊证列表。当前 C++ SDK 不接收旧文档中的 filter_params 参数，且 page_size 位于 page 之前。

参数

参数名	类型	是否必填	描述
symbol	const utility::string_t	Yes	港股正股代码，如 `U("00700")`
page_size	int	No	每页数量；SDK 默认 `100`；大于 0 时发送给服务端
page	int	No	页码；SDK 默认 `0`；仅大于 0 时发送给服务端
sort_field_name	utility::string_t	No	排序字段；SDK 默认空字符串
sort_dir	utility::string_t	No	排序方向；SDK 默认 `U("SortDir_Ascend")`

web::json::value，SDK 从服务端响应中直接返回 items 数组。每项字段包括 symbol、name、type、secType、market、entitlementRatio、entitlementPrice、premium、breakevenPoint、callPrice、beforeCallLevel、expireDate、lastTradingDate、state、changeRate、change、latestPrice、volume、amount、outstandingRatio、lotSize、strike、inOutPrice、delta、leverageRatio、effectiveLeverage、impliedVolatility。

示例

#include "tigerapi/client_config.h"
#include "tigerapi/quote_client.h"

int main() {
    TIGER_API::ClientConfig config(false, U("your_config_directory_path"));
    TIGER_API::QuoteClient client(config);
    auto result = client.get_warrant_filter(
        U("00700"), 20, 0, U("expireDate"), U("SortDir_Ascend"));
    utility::ucout << result.serialize() << std::endl;
}

请求频率

基础频率：60 次/分钟（按 TigerId + 接口统计，60 秒滚动窗口）。

获取实时窝轮行情

value QuoteClient::get_warrant_real_time_quote(const value &symbols)
value QuoteClient::get_warrant_real_time_quote(const utility::string_t symbol)

说明

获取一个或多个窝轮/牛熊证的实时行情。旧方法名 get_warrant_briefs 在当前 SDK 中不存在，本 anchor 保留用于旧链接兼容。

参数

参数名	类型	是否必填	描述
symbols	const value&	Yes	JSON 字符串数组
symbol	const utility::string_t	Yes	单个窝轮或牛熊证代码；该重载内部构造数组

web::json::value 数组。关键字段包括合约信息、latestPrice、preClose、volume、premium、outstandingRatio、leverageRatio，窝轮还可能包含 impliedVolatility 和 delta。delta 表示窝轮理论价值对标的价格变化的敏感度。

示例

#include "tigerapi/client_config.h"
#include "tigerapi/quote_client.h"

int main() {
    TIGER_API::ClientConfig config(false, U("your_config_directory_path"));
    TIGER_API::QuoteClient client(config);
    auto result = client.get_warrant_real_time_quote(U("15792"));
    utility::ucout << result.serialize() << std::endl;
}

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "items": [
      {"symbol": "15678", "name": "AAPL CW A", "underlying": "AAPL.US", "strike": 300.0, "expiry": "2025-12-30", "type": "CALL", "latestPrice": 0.52},
      {"symbol": "15679", "name": "AAPL CW B", "underlying": "AAPL.US", "strike": 320.0, "expiry": "2026-03-30", "type": "CALL", "latestPrice": 0.35}
    ],
    "totalCount": 45
  }
}

请求频率

基础频率：60 次/分钟（按 TigerId + 接口统计，60 秒滚动窗口）。