Splits and dividends

Use this route to reconcile splits and cash dividends with a price-history workflow. Supply ticker or its symbol alias and constrain the date range when you know the event window. ratio applies to splits and cashAmount applies to dividends when the relevant value is available; neither field turns an event into a total-return calculation. Preserve the ex-date, source-rights, provenance, freshness, and revision fields, and treat an empty list as no returned events for the requested range rather than proof that none occurred. See API conventions.

get/v1/market/corporate-actions

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/market/corporate-actions
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

tickerstring

Security symbol. Supply ticker or symbol.

symbolstring

Alias for ticker. Supply ticker or symbol.

date_fromstring date

Inclusive first event date in YYYY-MM-DD format. Defaults to approximately one year before the request.

date_tostring date

Inclusive last event date in YYYY-MM-DD format. Defaults to the request date.

limitinteger

Maximum actions to return. Values above 1,000 are capped.

Response

Split and dividend events for the requested security and date range.

dataAsOfstring
freshnessStatus'fresh' | 'stale' | 'degraded' | 'unknown'
methodologyVersionstring
materializationVersionstring
object'list' required
hasMoreboolean required
nextCursorstring nullable required
queryPathstring nullable required
queryPathReasonstring nullable required
policyYearsobject nullable required
degradedStateobject nullable
requestIdstring required
traceparentstring required
responseModestring
includestring[]

Changes

No recorded changes to this operation across all 1 revision of this API.