Intrinio provides corporate actions data for companies around the world with the help of our partner, Exchange Data International (EDI). A corporate action is any event that has a material impact on a company's shareholders and can include anything from a merger to a dividend. This article explains the corporate actions API, including important links to resources, what is included, how much this data feed costs, and how to access it via API.
- Corporate Actions API Documentation
- Corporate Actions Data Feed Page
- Sample JSON File for Apple
- Sample JSON File for the NASDAQ Exchange
- Getting Started Guide for Intrinio's API
- Build API Syntax
What data is included in the Corporate Actions API
The corporate actions API includes more than 45 types of corporate actions for more than 130,000 international securities. The exhaustive list of corporate action types can be viewed here. These corporate actions data fields are available for all major United States exchanges and many prominent international exchanges.
Here are a few of the 45 types of actions that are included:
- Buy Backs
- Capital Reductions
- Company Meetings
- Reverse Stock Splits
- Dividend Reinvestment Plans
- Incorporation Changes
- Purchase Offers
Each type of corporate action can have many data points relating to the corporate action. For example, a dividend is a type of corporate action and there are multiple data points relating to that action including the ex date and the pay date.
This makes the corporate actions API multi-dimensional, meaning one corporate event for one security can have multiple data points relating to that event. These data points are returned in nested JSON format.
This multi-dimensionality makes this one of the hardest, and most valuable, financial data sets for a firm to integrate. This complexity also explains why this data is only available in API format for integration into enterprise level applications.
How Much Does This Data Cost?
The complex nature of this data feed, as well as the extraordinary alpha it can provide, requires custom pricing from Exchange Data International. This custom pricing is determined by several factors:
- Will the data be used for internal purposes or will it be redistributed? Limiting usage to internal purposes reduces the cost.
- Which exchanges are required? Subscribers only pay for the markets they need.
- How big is your company? Startups and smaller firms can get a discount.
Other providers of corporate actions APIs often times exclude exchange fees and other costs when quoting a price. Intrinio includes all costs in price quotes with no surprises. Users accessing corporate actions through the Intrinio Fintech Marketplace pay the same price as going through EDI directly and benefit from Intrinio's support, SDKs, and documentation.
Quotes are generally returned within 1 business day and are paid month to month, meaning users can cancel at anytime. A quote and a free trial are always made available before any subscription.
Accessing the Corporate Actions API
The corporate actions API can be queried by exchange or by security. Patrick Industries Inc, a US based company, can be queried with this syntax:
The API explorer makes it easy to build this syntax, allowing users to search for US and International securities via a GUI to build and test API calls that return the latest corporate actions for a security.
Similarly, results can be obtained for an entire exchange:
In this case, results for the New York Stock Exchange are returned:
Using the stock exchange endpoint, developers can return the exchange identifier and pull the most recent corporate actions for all securities on a given exchange.
The challenge for any developer attempting to integrate this data feed is parsing the nested JSON and building an internal mapping structure based on the identifying codes that come with each type of corporate action. This documentation provides a starting point for this task and Intrinio is hard at work building out further documentation that will make it easier to build these links.
The biggest advantage of working with Intrinio is that free chat support is provided for all users. If you'd like to take a free trial to explore the data or come across a corporate action definition that you can't understand, our team of experts will coordinate with EDI and Intrinio's developers to get you an answer.