Help center › Data Feed Reference › Market data

Corporate actions · corporateaction 1.1

Corporate actions. Stock splits and cash dividends. A split adjusts every open tax lot (quantity times the ratio, unit cost divided by it) on the ex-date; a dividend books cash to each account holding the security. Applied deterministically and undoable with the batch. Key: ref.

Namespace: urn:vestoris:feed:corporateaction:1.1
Schema: corporateaction-1.1.xsd
Also accepted: urn:vestoris:feed:corporateaction:1.0 (corporateaction-1.0.xsd)
Key (upsert): ref: a record with an existing key updates it; a new key inserts.
Start-of-day step: Corporate actions
File name: F00012_CORPORATEACTION_20261023_001.xml
Modes: delta; full behaves as delta for this format

The <feed> root #

Attribute	Use	Type	Meaning
`businessDate`	required	`xs:date`	The business date the data is for (YYYY-MM-DD).
`firm`	required	`xs:string`	Your firm code, shown on Data › Feeds (e.g. F00012).
`source`	optional	`xs:string`	Who produced the file (vendor or system name).
`generated`	required	`xs:dateTime`	When the file was produced (UTC).
`recordCount`	required	`xs:nonNegativeInteger`	The number of record elements. A file whose count does not match is refused (F004): it was probably cut short.
`mode`	optional (default delta)	`xs:string`	delta: only the records in the file change. full: the file is complete (this data set has no inactivation: full behaves as delta).

The <record> elements #

upsert (insert or update by key). Elements may appear in any order; an element that is left out keeps its current value.

Element	Required	Type	Meaning	Codes
`ref` key #	yes	`xs:string` pattern [A-Z0-9][A-Z0-9_.\-]{0,39}	Your (or the vendor's) reference for the event. The key. A code: letters, digits, "_", "." or "-", up to 40. Part of the key. Example: `CA-2026-0042`	`R101` `R111`
`symbol` #	yes	`xs:string` pattern [A-Z][A-Z0-9.\-]{0,11}	The security. A ticker symbol: letters, digits, "." or "-", up to 12. Example: `NVDA`	`R101` `R111` `R109`
`kind` #	yes	`xs:string` one of: split, dividend	split or dividend. One of: split, dividend. Example: `split`	`R101` `R112`
`exDate` #	yes	`xs:date`	The ex-date: the action applies to holdings at the start of this day. An ISO date, YYYY-MM-DD. Example: `2026-11-03`	`R101` `R102`
`payDate` #	no	`xs:date`	Payment date (dividends). An ISO date, YYYY-MM-DD. Example: `2026-11-20`	`R102`
`ratio` #	no	`xs:decimal` ≥ 0.000001; ≤ 1000; 25 digits; 10 decimals	Split: new shares per old share (2 for a 2-for-1 split, 0.1 for a 1-for-10 reverse split). A decimal number written as text, e.g. 1234.5 (min 1.0E-6 max 1000). Example: `2`	`R103` `R111`
`amount` #	no	`xs:decimal` ≥ 0; ≤ 100000; 25 digits; 10 decimals	Dividend: cash per share, in the security's currency. A decimal number written as text, e.g. 1234.5 (min 0 max 100000). Example: `0.25`	`R103` `R111`

Validation #

No DOCTYPE or entity declaration (F002); well-formed UTF-8 (F001).
The namespace and version are published (F007), and the file matches the XSD (F003).
Header: firm is your firm code (F006), businessDate a business day (F005), recordCount the number of records (F004).
Each record: the field checks in the table above, references to records that exist (R109), no key twice in a file (R110). A rejected record does not stop the rest of the file.
Applied on the ex-date: at load time if it has passed, otherwise by the start-of-day chain.
An applied action cannot be changed by a later file; undo its batch instead.

Codes this format can return: F001 F002 F003 F004 F005 F006 F007 F008 R101 R102 R103 R109 R110 R111 R112

Sample #

An annotated file: the comment lines explain the header; drop them or keep them, comments are allowed.

<?xml version="1.0" encoding="UTF-8"?>
<!-- businessDate: the date the data is for. firm: your firm code. recordCount: how many <record> elements follow. -->
<feed xmlns="urn:vestoris:feed:corporateaction:1.1" businessDate="2026-10-23" firm="F00012" source="ExampleVendor" generated="2026-10-23T22:05:00Z" recordCount="2" mode="delta">
  <record action="upsert">
    <ref>CA-2026-0042</ref>
    <symbol>NVDA</symbol>
    <kind>split</kind>
    <exDate>2026-11-03</exDate>
    <ratio>2</ratio>
  </record>
  <record action="upsert">
    <ref>CA-2026-0043</ref>
    <symbol>KO</symbol>
    <kind>dividend</kind>
    <exDate>2026-11-14</exDate>
    <payDate>2026-12-01</payDate>
    <amount>0.51</amount>
  </record>
</feed>

Download the sample Download the XSD Validate a file

Version history #

1.0 (2026-10-26): First published version.
1.1 (2026-10-26): Adds the optional <udfs> element (up to ten <udf slot="1..10" name="...">value</udf>) to the reference formats that carry user-defined fields: security, issuer, account, accountgroup, broker, model, benchmark and list. Additive: every valid 1.0 file is still accepted under its 1.0 namespace.