GateData.AI

Corporate actions

Query splits, dividends, and other corporate actions.

GET/api/v1/fundamentals/corporate-actions
Domain
Fundamentals
Level
Public-company entity
MCP tool
fundamentals_query (task=corporate_actions)

Available data

Returns
Splits, dividends, and other corporate actions
Market coverage
US and Hong Kong equities
Query granularity
One company per query; filter by action type or time window

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company positioning

Provide query, symbol, or ticker when possible; an empty request returns no_data.

querystringqueryExampleAAPLoptional

Search text used to identify the object you want.

symbolstringqueryExampleAAPLoptional

Company symbol; compatibility alias of query.

tickerstringqueryExampleAAPLoptional

Company ticker.

Query options

All optional.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
actions[]object[]

Corporate actions: action_type (dividend/split/buyback/merger/listing_change/redemption), action_sub_type, effective_date, ratio_from/to, cash_per_share, merger/rename fields, …

corporate_action_idstringExamplecorp_action_76ddeac23568cebc

Corporate action id

action_typestringExamplesplit

Action type (dividend/split/buyback/merger/listing_change/redemption)

action_sub_typestring | nullExamplereverse_split

Action subtype

asset_idstring

Linked asset id

entity_idstring

Linked entity id

instrument_idstring

Linked instrument id

listing_idstring

Linked listing id

venue_idstring

Linked venue id

announcement_datestring | null

Announcement date

effective_datestring | nullExample2026-01-28

Effective date

ex_datestring | nullExample2026-01-28

Ex-date

record_datestring | nullExample2026-01-28

Record date

payment_datestring | nullExample2026-01-28

Payment date

process_datestring | nullExample2026-01-28

Process date

expiration_datestring | null

Expiration date

currencystring | null

Currency

amountnumber | null

Amount

pricenumber | null

Price

cash_per_sharenumber | null

Cash per share

cash_ratenumber | null

Cash rate

rationumber | nullExample4:1

Ratio

ratio_fromnumber | nullExample4

Split/conversion from

ratio_tonumber | nullExample1

Split/conversion to

acquirer_symbolstring | null

Acquirer symbol

acquirer_ratenumber | null

Acquirer rate

acquiree_symbolstring | null

Acquiree symbol

acquiree_ratenumber | null

Acquiree rate

source_symbolstring | null

Source symbol

source_ratenumber | null

Source rate

target_symbolstring | null

Target symbol

target_ratenumber | null

Target rate

alternate_symbolstring | null

Alternate symbol

alternate_ratenumber | null

Alternate rate

old_symbolstring | null

Old symbol (rename)

new_symbolstring | null

New symbol (rename)

data_statusDataStatusExampleok

Per-row readiness

empty_reasonstring | null

Per-row empty reason

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

empty_reasonstring | null

Empty / partial reason code when applicable

errorobject | null

Error object (code / message); null on success

metadataobject
actual_taskstringExamplecorporate_actions

Routed task: profile / statements / metrics / …

data_statusDataStatusExampleok

ok / partial / no_data / not_ready / stale

limitations[]string[]Exampleserving_mvp

Coverage / MVP limitation tags

route_reasonstringExampleexplicit_task

Route reason (e.g. explicit_task)

updated_atdatetime | stringExample2026-08-17T08:25:08Z

Envelope update time (UTC)

object_refs[]object[]

Unified object references

external_refs[]object[]

External refs (e.g. SEC EDGAR filings)

lineage_refs[]object[]

Lineage refs (usually [] on the public body)

source_refs[]object[]

Upstream source refs (usually [] on the public body)

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.