get_corporate_actions
Retrieve and format corporate action announcements such as splits, dividends, and mergers by date, symbol, type, or region.
Instructions
Retrieves and formats corporate action announcements.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_corporate_actions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | The inclusive end of the interval. The corporate actions are sorted by their `process_date`. Format: YYYY-MM-DD. Default: current day. | |
| ids | No | A comma-separated list of corporate action IDs. This parameter is mutually exclusive with all other filters (symbols, types, start, end, region, data_quality). | |
| sort | No | Sort data in ascending or descending order. | |
| limit | No | 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. | |
| start | No | The inclusive start of the interval. The corporate actions are sorted by their `process_date`. Format: YYYY-MM-DD. Default: current day. | |
| types | No | 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 - partial_call - reorganization - capital_gains_distribution | |
| cusips | No | A comma-separated list of CUSIPs. | |
| region | No | The region to filter corporate actions by. - `us`: only US corporate actions - `non_us`: only non-US corporate actions - `all`: both US and non-US corporate actions | us |
| symbols | No | A comma-separated list of symbols. | |
| page_token | No | 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. | |
| data_quality | No | Controls which corporate actions are returned based on data quality. - `complete` (default): exclude corporate actions that are still missing required fields (for example, ex-date or CUSIP/ISIN) and have not yet been processed. Already-processed corporate actions are always included, even if they would otherwise be considered incomplete. - `all`: return matching corporate actions regardless of field completeness. | complete |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||