API Enterprise

An ORTEX dividend forecast is our expectation for one future dividend of one listing: when it will be declared, its ex-date, record date and pay date, and how much it will be. ORTEX forecasts every dividend-paying listing it covers and updates the forecasts every day from the listing's own payment history, its reported results and the market it trades in. Once the company declares the dividend, the row shows the declared amount beside the forecast.

This feed returns every current forecast, for every listing in the requested region, whose expected ex-date falls inside the window. Every row carries the full instrument identity block so it can be joined onto your own security master. The response is uncharged.

Available Data Points:

• Company: The name of the company issuing the security.
• Ticker: The ticker symbol associated with the security.
• Operating MIC: The operating Market Identifier Code of the security.
• MIC: The Market Identifier Code (MIC) for the traded security.
• ISIN: The International Securities Identification Number for the security.
• FIGI: The Financial Instrument Global Identifier.
• Share Class FIGI: The Financial Instrument Global Identifier for the share class.
• Ortex Company ID: Unique id for a company.
• Ortex Security ID: Unique id for a security issued by a company.
• Ortex Tradable item ID: Unique id for a listing of a security.
• Ortex Tradable item main indicator: Indicates if the trading item is the main trading item for the security.
• Tradable Item Currency: The currency of the tradable item.
• Exchange Country: The country location of the exchange.
• Event Key: Stable key of the event: the year and the slot in the payment cycle, e.g. 2026-Q4, 2026-H1, 2026-FY.
• Period: Display form of the event key, e.g. Q4 2026, Interim 2026, Final 2026.
• Sequence: 1 for the listing's next event, 2 for the one after, and so on.
• Kind: regular, special, extra, initiation, return_of_capital, liquidation or stock.
• Frequency: The listing's payment cadence: weekly, monthly, quarterly, semi_annual, annual or irregular.
• Status: status is forecast (not yet declared), late (the expected declaration date has passed with nothing declared; daysLate counts the days) or declared (the company has declared it, and declaredAmount, declaredAt and declaredVsForecast are filled).
• Days Late: Days past the expected declaration date with nothing declared; 0 when not late.
• Declaration Date: Expected declaration date, with Declaration Band Days either side.
• Ex Date: Expected ex-dividend date, with Ex Band Days either side. The declared date once declared.
• Record Date / Pay Date: Expected record and pay dates. The declared dates once declared.
• Date Confidence: How consistently the listing's past dates followed the pattern used, 0 to 1.
• Currency: ISO 4217 code of the dividend currency.
• Base Amount: The last regular payment in the same slot, split-adjusted: what the change is measured against.
• Amount P10 / P50 / P90: The forecast amount: central (P50) and the 10th and 90th percentiles.
• Change Pct: Amount P50 against Base Amount, in percent.
• P Raise / P Hold / P Cut / P Omit: Outcome probabilities as fractions from 0 to 1; they add up to 1.
• P Special: Probability of a special or extra payment around the event, 0 to 1.
• Outcome / Outcome Probability: The most likely outcome (special when pSpecial is 0.5 or more) and its probability.
• Options Implied: The dividend implied by listed option prices to the first expiry after the ex-date, where there is one.
• Declared Amount / Declared At: The declared amount and when ORTEX first knew of the declaration (UTC).
• Declared Vs Forecast: exact, above or below: the declared amount against Amount P50.
• Forecast As Of: The date of the forecast run the row comes from.
• Reviewed: true when ORTEX staff reviewed this forecast and the row shows the reviewed values: a review can change the dates, the central amount (Amount P10 and P90 widen to include it) and the kind. false otherwise. The probabilities are always the ORTEX forecast's own.
• Holdings Amount: ETFs only: the distribution estimated from what the fund holds (its constituents' paid, declared and forecast dividends over the distribution period, net of withholding and the expense ratio, calibrated on the fund's past distributions), beside Amount P50. Null for other listings.
• Holdings Coverage Pct: ETFs only: the share of the fund's equity weight the holdings estimate covers.
• Holdings As Of: ETFs only: the date of the holdings file the estimate was made from.

Probabilities

The four outcome probabilities compare the next payment with the last regular payment in the same slot of the payment cycle (the same quarter, half or year): pRaise, pHold, pCut and pOmit (no payment at all) add up to 1. pSpecial is a separate figure: the chance of a special or extra payment around the event, which can come with any of the four. The probabilities are calibrated, which means that across many events a 30% figure comes true about 30% of the time; the published scorecard measures how well that holds.

Amounts and dates

Amounts are per share in the dividend currency, adjusted for splits to today's share count. amountP50 is the central forecast; amountP10 and amountP90 bound the range we expect the declared amount to fall in four times out of five. Forecast dates carry a band in business days (exBandDays, declarationBandDays): the date we expect, plus or minus the band.

Region and window

Use region to select the universe (a region name, an ISO-2 country code, or ALL; defaults to US). from_date (required) and to_date (defaults to today) bound the forecast ex-date and may span at most 366 days; a forward-looking window such as today to a year ahead is the usual request. Events whose ex-date is not yet forecast are not included. Results are ordered by ex-date, earliest first.

Identity and coverage

Forecasts ORTEX could not match to a listing are not included: a row with no listing has no country to place it in a region by, so the feed is limited to well-mapped issuers. Delisted listings are included, but every row's identity columns (company name, ticker, ISIN and the ORTEX ids) are the listing's current values rather than those it carried on the event's date; ISIN is null where the listing no longer has an active ISIN.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Contact [email protected]