API Enterprise
ORTEX index dividend points by futures expiry: one row per index and monthly expiry, the index dividends expected in the window in index points, with a range for the amounts and the ex-dates.
The windows are the next four monthly futures expiries of the Hang Seng Index (HSI), the Hang Seng China Enterprises Index (HSCEI) and the Hang Seng TECH Index (HSTECH). An HKEX index future expires on the business day before the last business day of its month; a window counts the dividends going ex after the expiry before, up to and including its own expiry.
Paid and declared dividends count in full in the window of their ex-date. An ORTEX forecast dividend is spread over the business days around its forecast ex-date, from the forecast's own date band (the range that held 80% of the method's past ex-dates) and date confidence (the share it hit exactly), and counts in each window at the probability that it goes ex there. A dividend D on a stock with index weight w and price P adds w x L x D / P points, L being the index level, on the date of the weights (the index's tracker fund holdings, refreshed quarterly).
Available Data Points:
- Index: The ORTEX index code: HSI, HSCEI or HSTECH.
- Index Name: The index's ORTEX display name.
- Currency: The index currency: points are in this currency.
- Contract Month / Expiry: The futures contract month and its expiry date.
- Period Start / Period End: The first and last ex-date the window counts (both inclusive).
- Period Status: closed, open (today is in the window) or upcoming.
- Paid Points / Declared Points: Dividends already ex, and declared dividends still to go ex, in points.
- Forecast Points: The ORTEX forecasts' expected points in the window (each weighted by its probability).
- Points P50: Paid plus declared plus forecast: the central estimate of the window's dividend points.
- Points P10 / Points P90: The range: every forecast at its own p10 (or p90) together, widened by the timing (Timing Points).
- Timing Points: The part of the range that is ex-date risk: the p10 to p90 half-width of the points from whether each forecast goes ex in this window or the next.
- Yield Pct / Yield P10 Pct / Yield P90 Pct: The points over the index level, in percent.
- Forecast Weight Pct: Index weight of the constituents with a forecast in the window.
- Level / Level Date: The index level the points are measured against, and its date.
- Weights As Of: The date of the tracker fund holdings used.
- Constituents: Constituents in the weights.
- Forecasts Visible: False when the forecast figures are withheld (see Publishing).
Levels
Points need the index level. ORTEX holds the HSI's; for the HSCEI and the HSTECH the points are null and the yield (points over the level) is served: multiply it by the level for points.
Publishing
Paid and declared figures are always served. Where the forecasts of a constituent's country are not published, its forecast figures are null and Forecasts Visible is false.
Updates
Rebuilt once a day and again after each forecast run, with the index points table.
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 date range and a set of regions. The table has no date dimension, so a key whose allowed range ends before today is rejected; a region-limited key is rejected with 403 restrictedRegion.
Get full access! Contact [email protected]
