API TraderAPI QuantAPI Developer
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, and the forecast it replaced in forecastBeforeDeclaration.
This endpoint returns the listing's next events, nearest first: four by default, up to 24 with num_events. Declared events stay in the list until their ex-date has passed.
Available Data Points:
- 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: What the change and the probabilities are measured against, split-adjusted: the last regular payment in the same slot, or the latest payment for a payer on one level through the year.
- Amount P10 / P50 / P90: The forecast amount: central (P50) and the 10th and 90th percentiles. Once declared, all three are the declared amount in Currency.
- 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. Both are null when the model's lean is not supported by the forecast amount: a raise, hold or cut against a Change Pct beyond 1% either way, or a cut on a flat amount. A raise on a flat amount stands. The probabilities are still on the row. Once declared: what the company did against Base Amount, with probability 1.
- 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 Currency: ISO 4217 code of the declared amount. It can differ from Currency: some companies declare in one currency and pay in another.
- Declared Vs Forecast: exact, above or below: the declared amount against Forecast Before Declaration, converted at today's spot rate when Declared Currency differs from Currency.
- Forecast Before Declaration: The central forecast the declaration replaced, in Currency. Null before the declaration.
- 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 baseAmount, the last regular payment in the same slot of the payment cycle (the same quarter, half or year), or the latest payment for a payer on one level through the 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; once declared all three are the declared amount. Forecast dates carry a band in business days (exBandDays, declarationBandDays): the date we expect, plus or minus the band.
Four years ahead
The first eight events are the event forecasts described above. Ask for more than eight with num_events and the list continues to the end of the fourth calendar year after this one. Each later event repeats the listing's payment cycle on its usual dates, its amount grows with the dividend growth expected for the coming fiscal years, and it carries an Amount P10 to P90 range that widens with the years. Tested on past years from 2008 on, the range held about eight times in ten for listings that kept paying. These later events carry no probabilities, no date confidence and no options-implied amount.
No date window
A forecast describes what we expect today, so this endpoint takes no from_date or to_date. For past forecasts beside what was declared, use the forecast history endpoint.
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! Get a key at app.ortex.com/apis
