获取公司行动数据

获取公司行动

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	Yes	市场；SDK 默认空字符串，但服务端拒绝空值
action_type	utility::string_t	Yes	行动类型；SDK 默认空字符串，但服务端拒绝缺失或空值。便捷方法固定为 `symbol_change`、`delisting` 或 `ipo`
begin_date	utility::string_t	Yes	开始日期，`yyyy-MM-dd`；SDK 默认空字符串但服务端要求提供
end_date	utility::string_t	Yes	结束日期，`yyyy-MM-dd`，不得早于开始日期；SDK 默认空字符串但服务端要求提供

web::json::value 对象，键为请求代码，值为该代码的公司行动数组。数组项的共享字段为 symbol、market、exchange、executeDate、actionType。其他字段由 action_type 决定，下表列出各变体字段。

变体字段：

`action_type`	额外字段
`symbol_change`	`oldSymbol`、`newSymbol`
`delisting`	`announcedDate`、`reason`
`ipo`	`ipoName`、`listingDate`、`listingPrice`、`sharesOutstanding`、`sharesFloat`、`offerAmount`、`priceRange`、`currency`、`country`、`minPurchaseQuantity`、`leverageRatio`

示例

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

请求频率

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

查询代码变更

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，返回代码变更字段。

参数约束与 get_corporate_action 相同。虽然 C++ 默认值为空字符串，但服务端要求 market、begin_date 和 end_date 均非空。

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

请求频率

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

查询退市

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，返回退市字段。

参数约束与 get_corporate_action 相同。虽然 C++ 默认值为空字符串，但服务端要求 market、begin_date 和 end_date 均非空。

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

请求频率

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

查询 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，返回 IPO 字段。

参数约束与 get_corporate_action 相同。虽然 C++ 默认值为空字符串，但服务端要求 market、begin_date 和 end_date 均非空。

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

权限与限制

需要对应市场的额外基本面数据权限；普通行情权限不足以调用。

请求频率

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