Announcements #

The announcements endpoint contains public information on previous and upcoming dividends, mergers, spinoffs, and stock splits.

Announcement data is made available through the API as soon as it is ingested by Alpaca, which is typically the following trading day after the declaration date. This provides insight into future account stock position and cash balance changes that will take effect on an announcement’s payable date. Additionally, viewing previous announcement details can improve bookkeeping and reconciling previous account cash and position changes.

Get announcements

GET /v2/corporate_actions/announcements
Returns announcements data given specified search criteria.

Parameters

Query Parameters

Attribute Type Requirement Description
ca_types string
Required
A comma-delimited list of Dividend, Merger, Spinoff, or Split.
since timestamp
Required
The start (inclusive) of the date range when searching corporate action announcements. This should follow the YYYY-MM-DD format. The date range is limited to 90 days.
until timestamp
Required
The end (inclusive) of the date range when searching corporate action announcements. This should follow the YYYY-MM-DD format. The date range is limited to 90 days.
symbol string
Optional
The symbol of the company initiating the announcement.
cusip string
Optional
The CUSIP of the company initiating the announcement.
date_type string
Optional
declaration_date, ex_date, record_date, or payable_date.

Response

An array of Announcement objects.

Get a specific announcement

GET /v2/corporate_actions/announcements/{id}
Returns a specific announcement.

Response

An Announcement object.

Announcement Entity #

Example #

[
  {
    "id": "be3c368a-4c7c-4384-808e-f02c9f5a8afe",
    "corporate_actions_id": "F58684224_XY37",
    "ca_type": "Dividend",
    "ca_sub_type": "DIV",
    "initiating_symbol": "MLLAX",
    "initiating_original_cusip": "55275E101",
    "target_symbol": "MLLAX",
    "target_original_cusip": "55275E101",
    "declaration_date": "2021-01-05",
    "expiration_date": "2021-01-12",
    "record_date": "2021-01-13",
    "payable_date": "2021-01-14",
    "cash": "0.018",
    "old_rate": "1",
    "new_rate": "1"
  },
  {
    "corporate_action_id": "48251W104_AD21",
    "ca_type": "Dividend",
    "ca_sub_type": "cash",
    "initiating_symbol": "KKR",
    "initiating_original_cusip": "G52830109",
    "target_symbol": "KKR",
    "target_original_cusip": "G52830109",
    "declaration_date": "2021-11-01",
    "ex_date": "2021-11-12",
    "record_date": "2021-11-15",
    "payable_date": "2021-11-30",
    "cash": "0.145",
    "old_rate": "1",
    "new_rate": "1"
  }
]

Properties #

Attribute Type Description
id string/UUID ID that is specific to a single announcement.
corporate_action_id string ID that remains consistent across all announcements for the same corporate action. Unlike ‘id’, this can be used to connect multiple announcements to see how the terms have changed throughout the lifecycle of the corporate action event.
ca_type string dividend, merger, spinoff, or split
ca_sub_type string When ca_type = dividend, then cash or stock. When ca_type = merger, then merger_update or merger_completion. When ca_type = spinoff, then spinoff. When ca_type = split, then stock_split, unit_split, reverse_split, or recapitalization.
initiating_symbol string Symbol of the company initiating the announcement.
initiating_original_cusip string CUSIP of the company initiating the announcement.
target_symbol string Symbol of the child company involved in the announcement.
target_original_cusip string CUSIP of the child company involved in the announcement.
declaration_date string Date the corporate action or subsequent terms update was announced.
ex_date string The first date that purchasing a security will not result in a corporate action entitlement.
record_date string The date an account must hold a settled position in the security in order to receive the corporate action entitlement.
payable_date string The date the announcement will take effect. On this date, account stock and cash balances are expected to be processed accordingly.
cash string The amount of cash to be paid per share held by an account on the record date.
old_rate string The denominator to determine any quantity change ratios in positions.
new_rate string The numerator to determine any quantity change ratios in positions.