获取公司行动数据

公司行动相关接口共同占用 60 次/分钟的频率限制。

获取公司行动

value QuoteClient::get_corporate_action(const value &symbols, utility::string_t market = U(""), utility::string_t action_type = U(""), utility::string_t begin_date = U(""), utility::string_t end_date = U(""))

参数

参数名	类型	是否必填	描述
symbols	const value&	Yes	JSON 代码数组
market	utility::string_t	No	市场；SDK 默认空字符串
action_type	utility::string_t	No	行动类型；空字符串由服务端处理；便捷方法固定为 `symbol_change`、`delisting` 或 `ipo`
begin_date	utility::string_t	No	开始日期，`yyyy-MM-dd`；SDK 默认空
end_date	utility::string_t	No	结束日期，`yyyy-MM-dd`；SDK 默认空

web::json::value，字段随行动类型变化，通常包含代码、市场、行动类型、生效日期和行动详情。

示例

#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);
    web::json::value symbols = web::json::value::array();
    symbols[0] = web::json::value::string(U("AAPL"));
    auto result = client.get_corporate_action(
        symbols, U("US"), U("symbol_change"), U("2025-01-01"), U("2025-12-31"));
    utility::ucout << result.serialize() << std::endl;
}

响应依据

SDK 返回未建模的 web::json::value，仓库中没有已验证公司行动 fixture，因此不推造日期或字段。

查询代码变更

value QuoteClient::get_corporate_symbol_change(const value &symbols, utility::string_t market = U(""), utility::string_t begin_date = U(""), utility::string_t end_date = U(""))

调用 get_corporate_action 并固定 action_type 为 symbol_change。参数、返回、权限和频率限制相同。

auto result = client.get_corporate_symbol_change(
    symbols, U("US"), U("2025-01-01"), U("2025-12-31"));

查询退市

value QuoteClient::get_corporate_delisting(const value &symbols, utility::string_t market = U(""), utility::string_t begin_date = U(""), utility::string_t end_date = U(""))

调用 get_corporate_action 并固定 action_type 为 delisting。

auto result = client.get_corporate_delisting(symbols, U("US"));

查询 IPO

value QuoteClient::get_corporate_ipo(const value &symbols, utility::string_t market = U(""), utility::string_t begin_date = U(""), utility::string_t end_date = U(""))

调用 get_corporate_action 并固定 action_type 为 ipo。

auto result = client.get_corporate_ipo(symbols, U("US"));

权限与链接

需要对应市场的公司基本面/行情权限。日期范围和结果字段由服务端接口决定；频率为本页四个方法共享 60 次/分钟。源码签名见 include/tigerapi/quote_client.h。