公司行动
查询拆股、分红等公司行动。
GET/api/v1/fundamentals/corporate-actions
可查询数据
- 返回数据
- 拆股、分红等公司行动
- 市场覆盖
- 美股、港股
- 查询粒度
- 每次查询一家公司，可按类型或时间筛选
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
公司定位
建议填写 query、symbol 或 ticker；留空时接口返回 no_data。
querystringquery示例AAPL可选查询关键词、代码或名称。
symbolstringquery示例AAPL可选资产代码。
tickerstringquery示例AAPL可选资产代码。
响应
dataobject
actions[]object[]
公司行动：action_type（dividend/split/buyback/merger/listing_change/redemption）、action_sub_type、effective_date、ratio_from/to、cash_per_share、并购/更名字段等
corporate_action_idstring示例corp_action_76ddeac23568cebc公司行动 id
action_typestring示例split行动类型
action_sub_typestring | null示例reverse_split行动子类型
asset_idstring资产标识，标识股票、加密资产等资产对象
entity_idstring主体标识，标识公司、项目方或协议等主体
instrument_idstring交易工具标识，标识股票、现货交易对或合约等具体交易产品
listing_idstring交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录
venue_idstring交易场所标识，标识交易所或交易平台
announcement_datestring | null公告日
effective_datestring | null示例2026-01-28生效日
ex_datestring | null示例2026-01-28除权日
record_datestring | null示例2026-01-28登记日
payment_datestring | null示例2026-01-28支付日
process_datestring | null示例2026-01-28处理日
expiration_datestring | null到期日
currencystring | null货币
amountnumber | null金额
pricenumber | null价格
cash_per_sharenumber | null每股现金
cash_ratenumber | null现金比例
rationumber | null示例4:1比例
ratio_fromnumber | null示例4拆分/换股分子
ratio_tonumber | null示例1拆分/换股分母
acquirer_symbolstring | null收购方代码
acquirer_ratenumber | null收购方比例
acquiree_symbolstring | null被收购方代码
acquiree_ratenumber | null被收购方比例
source_symbolstring | null源代码
source_ratenumber | null源比例
target_symbolstring | null目标代码
target_ratenumber | null目标比例
alternate_symbolstring | null备选代码
alternate_ratenumber | null备选比例
old_symbolstring | null旧代码（更名）
new_symbolstring | null新代码（更名）
行级就绪状态
empty_reasonstring | null行级空原因
ok / partial / no_data / not_ready / stale
empty_reasonstring | null空结果或部分缺失原因码
errorobject | null错误对象（code / message）。
metadataobject
actual_taskstring示例corporate_actions实际路由任务：profile / statements / metrics / …
ok / partial / no_data / not_ready / stale
limitations[]string[]示例serving_mvp覆盖 / MVP 限制标记
route_reasonstring示例explicit_task路由原因（如 explicit_task）
updated_atdatetime | string示例2026-08-17T08:25:08Z响应更新时间（UTC）
object_refs[]object[]统一对象引用数组
external_refs[]object[]外部引用（如 SEC EDGAR filings）
lineage_refs[]object[]血缘引用（公开体通常为空数组）
source_refs[]object[]数据来源引用（公开体通常为空数组）
错误与降级
200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。