Dividend-capture calendar and scorecard: answers "which ex-dividend events are

Dividend-capture calendar and scorecard: answers "which ex-dividend events are coming up, and how has capturing this name's dividend actually worked?" One row per ex-dividend event: the full schedule (declaration/record/pay dates, cash amount, frequency, type, annualized dividend, capture yield), the ex-day price action (cum-day close, ex open/close, price drop and drop ratio at open and close, net capture %), and the recovery record (breakeven price, recovery status/date, days to recover, recovered-within 1/3/5/10/20-day flags). A drop ratio well below 1 means the stock historically falls less than the dividend -- the raw material of a capture strategy.

Set upcoming=true for the forward ex-div calendar (default 7 days out, up to 120 via future_days); use ticker for one name's full capture history.

Requires an Alphanume Pro API key. A 403 PRO_SUBSCRIPTION_REQUIRED or DATE_RANGE_RESTRICTED error means the key's plan does not cover the request -- it does not mean the data is missing.

get/v1/dividend-capture

Request

  • Base URL: https://api.alphanume.com
  • URL: https://api.alphanume.com/v1/dividend-capture
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

tickerstring

Ticker symbol filter, e.g. 'AAPL'. Case-insensitive.

datestring

Exact date, YYYY-MM-DD. Cannot be combined with the date range parameters.

date_gtestring

Start of date range, inclusive (YYYY-MM-DD).

date_ltestring

End of date range, inclusive (YYYY-MM-DD).

date_gtstring

Start of date range, exclusive (YYYY-MM-DD).

date_ltstring

End of date range, exclusive (YYYY-MM-DD).

recovery_statusstring

Filter by the recovery_status label of the ex-div event (values as returned in the data, e.g. whether the price has recovered to breakeven yet).

upcomingboolean

If true, return only the FORWARD calendar: ex-dividend dates after today, out to future_days ahead. Overrides date range filters.

future_daysinteger

Forward horizon in calendar days for the upcoming calendar (default 7, max 120).

Response

Matching rows.

countinteger required
dataobject[] required

Changes

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