基金

C++ HTTP 方法返回完整响应中 data 字段的取值。本文示例中的外层 code、message、timestamp 以及 data 字段名本身不属于方法返回的 value。

获取基金代码列表

value QuoteClient::get_fund_symbols(utility::string_t lang = U(""))

说明

获取所有基金代码列表

参数

参数名	类型	是否必填	描述
lang	utility::string_t	No	响应语言；SDK 默认空字符串，空值不发送

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_fund_symbols();
ucout << result.serialize() << std::endl;

获取基金合约信息

value QuoteClient::get_fund_contracts(const value &symbols, utility::string_t lang = U(""))

说明

批量获取基金的合约信息

参数

参数名	类型	是否必填	描述
symbols	value	Yes	基金代码数组，最多 500 只，如 `value::array({value::string(U("IE00B11XZ988.USD"))})`
lang	utility::string_t	No	响应语言；SDK 默认空字符串，空值不发送

web::json::value JSON 对象

其中数据项字段如下

名称	示例	说明
symbol	IE00B464Q616.USD	基金代码，后缀为货币
name	ASIA STRATEGIC INTEREST BOND FUND "E" (USD) INC MONTHLY	基金名称
company_name	PIMCO Global Advisors (Ireland) Limited	基金名称
market	US	市场 /US/HK/CN
sec_type	FUND	合约类别
currency	USD	USD/HKD/CNH
tradeable	true	是否可交易
sub_type	Fixed Income	子类别
dividend_type	INC	分红类型
tiger_vault	false	是否为老虎钱袋子

示例

#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 symbols = value::array();
symbols[0] = value::string(U("IE00B11XZ988.USD"));

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"symbol": "SPY", "name": "SPDR S&P 500 ETF", "secType": "FUND", "market": "US", "currency": "USD"},
    {"symbol": "QQQ", "name": "Invesco QQQ Trust", "secType": "FUND", "market": "US", "currency": "USD"}
  ]
}

获取基金最新行情

value QuoteClient::get_fund_quote(const value &symbols, utility::string_t lang = U(""))

说明

获取基金最新行情

参数

参数名	类型	是否必填	描述
symbols	value	Yes	基金代码数组，上限为 500 个
lang	utility::string_t	No	响应语言；SDK 默认空字符串，空值不发送

web::json::value JSON 对象

字段	类型	说明
symbol	string	标的代码
close	float	收市价
timestamp	int	毫秒单位的时间戳

示例

#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 symbols = value::array();
symbols[0] = value::string(U("IE00B11XZ988.USD"));
symbols[1] = value::string(U("LU0476943708.HKD"));

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

返回示例

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "symbol": "SPY",
      "open": 545.20,
      "high": 548.90,
      "low": 543.10,
      "close": 547.85,
      "preClose": 544.30,
      "latestPrice": 547.85,
      "volume": 52345000
    }
  ]
}

获取基金历史行情

value QuoteClient::get_fund_history_quote(
    const value &symbols, time_t begin_time = -1, time_t end_time = -1,
    int limit = 200, utility::string_t lang = U(""))

说明

获取基金历史行情

参数

参数名	类型	是否必填	描述
symbols	value	Yes	基金代码数组，上限为 500 个
begin_time	time_t	No	开始时间戳；SDK 默认 `-1`，仅正值发送
end_time	time_t	No	结束时间戳；SDK 默认 `-1`，仅正值发送
limit	int	No	SDK 默认 `200`，仅正值发送
lang	utility::string_t	No	响应语言；SDK 默认空字符串，空值不发送

web::json::value JSON 对象

字段	类型	说明
symbol	string	标的代码
nav	float	净值
time	int	时间戳

示例

#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 symbols = value::array();
symbols[0] = value::string(U("LU0476943708.HKD"));

value result = quote_client.get_fund_history_quote(symbols, 1691337600000, 1691596800000);
ucout << result.serialize() << std::endl;