Corporate action reference data

What is this endpoint for?

This endpoint offers supplementary corporate action reference data for any user subscribing to Capital Market Reference Rates from Kaiko. The data covers single stocks and ETFs, including dividends, stock splits, mergers, spin-offs, and other structural events that impact equity prices and trading. This endpoint provides real-time updates and historical corporate action events with event classifications and critical dates including ex-date, and payment date. The data can be used for price adjustment validations, corporate action tracking, and anticipating upcoming events that affect equity valuation.

Endpoints

gRPC

gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService.CorporateActions

Request fields

Parameter	Required	Description	Example
isins	No	List of Isin codes	["US78462F1030","US0378331005"]
start_ex_date	No	Start date of exDate in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z
end_ex_date	No	End date of exDate in ISO 8601 (exclusive).	2023-01-26T00:00:00.000Z

Response fields

Field	Description
eventUniqueID	The unique event ID
eventId	The event ID of the corporation
actionType	The type of the action. The output can be CASH_DIVIDEND, STOCK_DIVIDEND, SPECIAL_DIVIDEND, BONUS, STOCK_SPLIT, REVERSE_SPLIT, MERGER, TAKEOVER, SPINOFF, CAPITAL_REDUCTION, RIGHTS_ISSUE, ENTITLEMENT, DISTRIBUTION, RETURN_OF_CAPITAL, DELISTING.
ediEventCode	The event identifier.
status	The status of the action. The response can be UPCOMING, ACTIVE, COMPLETED, HISTORICAL, UNKNOWN.
eventCreatedAt	The UTC datetime that the event is created
lastUpdatedAt	The UTC datetime that the event is updated
caDetails	The details of the action
.actionType	The type of the action
.exDate	The UTC datetime of the first trading day when the equity is trading without the right in question.
.recordDate	The UTC datetime when the records are checked to identify the eligible recipients of a specific corporate action.
.paymentDate	The UTC datetime when the action is executed.
.dividendType	The type of dividend. The response can be REGULAR, SPECIAL, INTERIM, FINAL
idDetails	The details of the underlying security
.isin	The International Securities Identification Number (ISIN) code
.ticker	The asset identifier in the local exchanges
.issuerName	The name of the issuer
.exchangeMic	The Market Identifier Code (MIC) where the asset is traded on
.bbgCompId	The issuer ID on Bloomberg
.bbgCompTicker	The issuer Ticker on Bloomberg
.figi	The Financial Instrument Global Identifier (FIGI) code
.figiTicker	The Financial Instrument Global Identifier (FIGI) ticker
.timezone	The IANA timezone of the main trading venue

Request examples

cURL

cURL requests are intended for testing purposes only.

grpcurl \
  -H "Authorization: Bearer $KAIKO_API_KEY" \
  -d '{
    "start_ex_date": "2026-02-01T00:00:00.000Z",
    "end_ex_date":   "2026-02-28T00:00:00.000Z"
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService.CorporateActions

Response Example

{
  "corporateActions": [
    {
      "eventUniqueId": "201010274603172",
      "eventId": "4603172",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2026-02-07T05:00:00Z",
      "lastUpdatedAt": "2026-02-07T14:11:01Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-20T05:00:00Z",
        "recordDate": "2026-02-20T05:00:00Z",
        "paymentDate": "2026-03-19T04:00:00Z",
        "currency": "USD",
        "grossDividend": 0.68,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "US75513E1010",
        "ticker": "RTX",
        "issuerName": "RTX Corp",
        "exchangeMic": "XNYS",
        "bbgCompId": "BBG000BW8S60",
        "bbgCompTicker": "RTX US",
        "figi": "BBG000BW8TX8",
        "figiTicker": "RTX UN",
        "timezone": "America/New_York"
      }
    },
    {
      "eventUniqueId": "201010274577840",
      "eventId": "4577840",
      "actionType": "CASH_DIVIDEND",
      "ediEventCode": "DIV",
      "status": "UNKNOWN",
      "eventCreatedAt": "2026-01-27T15:00:00Z",
      "lastUpdatedAt": "2026-01-28T08:33:22Z",
      "caDetails": {
        "actionType": "CASH_DIVIDEND",
        "exDate": "2026-02-25T15:00:00Z",
        "recordDate": "2026-02-27T15:00:00Z",
        "currency": "KRW",
        "grossDividend": 1875,
        "dividendType": "REGULAR"
      },
      "idDetails": {
        "isin": "KR7000660001",
        "ticker": "000660",
        "issuerName": "SK Hynix Inc",
        "exchangeMic": "XKRX",
        "bbgCompId": "BBG000GQVT51",
        "bbgCompTicker": "000660 KS",
        "figi": "BBG000GQVTN1",
        "figiTicker": "000660 KP",
        "timezone": "Asia/Seoul"
      }
    },
    ...
  ]
}