Corporate Actions API For Developers

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.

Important Links

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:

  • Announcements
  • Buy Backs
  • Bankruptcy
  • Capital Reductions
  • Company Meetings
  • Reverse Stock Splits
  • Distributions
  • Dividends
  • Dividend Reinvestment Plans
  • Entitlements
  • Incorporation Changes
  • Lawsuits
  • Liquidations
  • Mergers
  • Purchase Offers
  • Takeovers

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.
  • How many years of history do you need? Subscriptions that include 6 months of history are more affordable than those with 1, 2 years, or 3 years.

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.

Request a Quote

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:

https://api.intrinio.com/securities/corporate_actions?identifier=PATK:US

 

Corporate Actions API

Corporate Actions for a US Security

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:

https://api.intrinio.com/stock_exchanges/corporate_actions?identifier=^XNYS

In this case, results for the New York Stock Exchange are returned:

Corporate Actions API NYSE

Corporate Actions for the NYSE

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 API explorer can also be configured to build and test syntax for exchanges.

When pulling corporate actions, either for a security or an exchange, the response will extend back between 6 months and 3 years, depending on the subscription. Paging makes it possible to pull extensive historical corporate actions.

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.

Ask us a Question

 

If you chat with our team we will be happy to add a free trial to your account.