窝轮牛熊证

筛选窝轮和牛熊证

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、latestPrice、strike、expiry、premium 和杠杆字段。

示例

#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;
}

响应依据

SDK 从服务端响应中直接取 items，但没有本地 warrant item 模型或已验证 fixture。字段以运行时响应为准，不提供合成价格或日期。

获取实时窝轮行情

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。

示例

#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
  }
}

响应依据

该方法返回服务端 items 数组，SDK 仓库没有固定响应模型或已验证 fixture，因此不提供合成行情 payload。