通用

C++ HTTP 方法返回响应中的 data 内容。本文包含 code、message、timestamp、data 的 JSON 仅用于展示完整接口响应；对返回的 value 调用 serialize() 时不含外层包装。

获取行情权限

value QuoteClient::get_quote_permission()

说明

获取当前账户的行情权限

web::json::value JSON 对象，包含行情权限信息

示例

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

using namespace TIGER_API;

ClientConfig config(false, U("your_config_directory_path"));
QuoteClient quote_client(config);

value result = quote_client.get_quote_permission();
ucout << result.serialize() << std::endl;

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"name": "usStockQuote", "expireAt": 1788120000000},
    {"name": "hkStockQuoteLv2", "expireAt": 1788120000000}
  ]
}

请求频率

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

抢占行情设备访问权

value QuoteClient::grab_quote_permission()

无参数。抢占行情设备访问权，将当前设备设为可访问行情的设备，并使同一账户的其他设备失去该设备访问权。此操作不会购买或授予新的行情权限。返回 web::json::value。

auto result = quote_client.grab_quote_permission();
utility::ucout << result.serialize() << std::endl;

需要已开通的行情权限。当前构造函数实现会调用此方法，而不读取 is_grab_permission 参数。

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "name": "usStockQuote",
    "expireAt": 1788120000000
  }
}

请求频率

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

获取 K 线额度

value QuoteClient::get_kline_quota(bool with_details = false)

说明

获取 K 线查询额度信息

参数

参数名	类型	是否必填	描述
with_details	bool	No	是否返回详细信息，默认 false

web::json::value JSON 对象

示例

ClientConfig config(false, U("your_config_directory_path"));
QuoteClient quote_client(config);

value result = quote_client.get_kline_quota(true);
ucout << result.serialize() << std::endl;

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "remain": 500,
    "used": 120
  }
}

请求频率

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

查询增值权限

value QuoteClient::get_addon_entitlements()

说明

查询账户当前启用的增值行情套餐和权限。

参数

无。

web::json::value 对象，字段如下：

字段	类型	说明
userLevel	integer	用户套餐等级
activePlan	object	当前套餐，含 `planType`、`expireTime`、`remainingDays`（剩余天数）
addons	array	附加套餐列表，每项含 `planType`、`active`、`startTime`、`expireTime`
effectiveEntitlement	object	生效权益额度，含股票/期货/期权历史额度、订阅额度、深度额度及高/中/低频额度等字段

示例

auto result = quote_client.get_addon_entitlements();

返回示例

{
  "userLevel": 3,
  "activePlan": {"planType": "PREMIUM", "expireTime": 1788120000000, "remainingDays": 30},
  "addons": [],
  "effectiveEntitlement": {"historyStockLimit": 10000, "historyStockRemaining": 9800, "subscribeLimit": 500, "subscribeRemaining": 480}
}

获取行情权限

抢占行情设备访问权

获取 K 线额度

查询增值权限

What’s Next