Corporate actions

get

https://data.alpaca.markets/v1/corporate-actions

This endpoint provides data about the corporate actions for each given symbol over a specified time period.

Warning

Currently Alpaca has no guarantees on the creation time of corporate actions. There may be delays in receiving corporate actions from our data providers, and there may be delays in processing and making them available via this API. As a result, corporate actions may not be available immediately after they are announced.

Query Params

symbols

string

A comma-separated list of symbols.

cusips

string

A comma-separated list of CUSIPs.

types

string

A comma-separated list of types. If not provided, search all types.

The following types are supported:

reverse_split
forward_split
unit_split
cash_dividend
stock_dividend
spin_off
cash_merger
stock_merger
stock_and_cash_merger
redemption
name_change
worthless_removal
rights_distribution

start

date

The inclusive start of the interval. The corporate actions are sorted by their process_date. Format: YYYY-MM-DD. Default: current day.

end

date

The inclusive end of the interval. The corporate actions are sorted by their process_date. Format: YYYY-MM-DD. Default: current day.

ids

string

A comma-separated list of corporate action IDs. This parameter is mutually exclusive with all other filters (symbols, types, start, end).

limit

integer

1 to 1000

Defaults to 100

Maximum number of corporate actions to return in a response. The limit applies to the total number of data points, not the count per symbol! Use next_page_token to fetch the next set of corporate actions.

page_token

string

The pagination token from which to continue. The value to pass here is returned in specific requests when more data is available, usually because of a response result limit.

sort

string

enum

Defaults to asc

Sort data in ascending or descending order.

Allowed:

Responses

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

500

Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

200OK

400One of the request parameters is invalid. See the returned message for details.

429Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.