Corporate actions

The corporate-action register — dividends, splits, bonuses, rights, coupons, mergers, and symbol changes — sourced reactively against the registry (MCDR) and the exchange. The list is chronological (most recent ex-date first); it carries no sentiment, score, or "don't-miss" framing.

Every field is a fact copied from the action: the type, the ratio, the dates, the per-share amount. There is no ranking and no urgency language — the register states what happened or will happen, and when (FRA Decision 332).

GET /v1/corporate-actions

List corporate actions, most-recent ex-date first. Pass ?symbol= to filter to a single instrument.

{
  "corporate_actions": [
    {
      "id": "ca_…",
      "market_id": "EGX",
      "symbol": "COMI",
      "type": "split",
      "gross_per_share_micros": null,
      "withhold_bps": 0,
      "ratio_from": 1,
      "ratio_to": 2,
      "subscription_price_micros": null,
      "cash_in_lieu_micros": null,
      "source": "mcdr",
      "currency": "EGP",
      "ex_date": "2026-06-10T00:00:00Z",
      "record_date": "2026-06-12T00:00:00Z",
      "pay_date": "2026-06-14T00:00:00Z",
      "status": "processed"
    }
  ],
  "ordering": "chronological"
}

Type taxonomy

type	What it is	Carries
cash_dividend	cash distribution per share	gross_per_share_micros, withhold_bps
stock_dividend	shares distributed per held share	ratio_from / ratio_to
bonus	bonus shares issued	ratio_from / ratio_to
split	share split (e.g. 1→2)	ratio_from / ratio_to
reverse_split	share consolidation	ratio_from / ratio_to
rights	rights issue / subscription entitlement	ratio_from / ratio_to, subscription_price_micros
coupon	fixed-income coupon payment	gross_per_share_micros (per nominal)
capital_change	capital increase / decrease	varies
merger	merger or absorption	varies
symbol_change	ticker / symbol change	—

Fields

Field	Notes
type	one of the taxonomy above
gross_per_share_micros	per-share (or per-nominal coupon) cash, for cash-paying types; null otherwise
withhold_bps	withholding applied to the gross, in basis points
ratio_from / ratio_to	the action ratio for unit-effect types (e.g. 1→2 for a 2:1 split)
subscription_price_micros	the price to subscribe, for a rights issue
cash_in_lieu_micros	cash paid for fractional entitlements that round down
source	mcdr (registry) or egid (exchange)
ex_date	the date the instrument trades ex-entitlement
record_date	the holder-of-record date (distinct from ex_date)
pay_date	the payment / effective date
status	lifecycle (e.g. declared, processed)

Reactive booking. Quantity actions (split, bonus, stock dividend) re-register whole units against the registry; fractional entitlements round down and pay the declared cash_in_lieu_micros. Caravan never invents rounding — the figures come from the action row.

Rights are entitlements, not opportunities. A rights row states the ratio, the subscription price, and the dates — factual entitlement narration. It carries no "subscribe now" or "attractive" framing.