Dividend history,
from ex-date to pay date.

What each dividend record contains

A dividend is a corporate action with one or more legs. A regular cash dividend has one leg carrying cash_amount and currency_code; a stock dividend carries a share ratio instead. Amounts are exact decimal strings.

Split-adjusted dividend history

Old dividends are reported as paid. If a company later splits 4-for-1, a $0.82 payment from before the split is $0.205 on today's share basis, and split_adjusted_amount gives you that number directly. Use it for growth rates and charts; use the raw cash_amount in the leg for what shareholders actually received. Johnson & Johnson's history in our data starts with an ex-date of 1970-02-16, where the raw amount and the split-adjusted amount differ by more than a hundredfold.

Dividend yield, payout ratio and streaks

GET /v1/financials/metrics publishes calculated dividend metrics per listing. All of the following were returning values for XNYS:JNJ on October 3, 2026:

• dividend_yield and forward_dividend_yield, as ratios (0.0209 is 2.09%)
• trailing_annual_dividend, in the listing currency
• payout_ratio
• dividend_yield_5y_avg and dividend_growth_5y
• dividend_payments_per_year
• dividend_paid_streak_years and dividend_increase_streak_years

Each metric has a published definition at metric definitions. Metrics cost 50 credits per symbol. The screener can filter on dividend_yield, forward_dividend_yield and payout_ratio.

Upcoming and market-wide dividends

Omit symbols and pass a from and to window of up to 366 days to get every dividend going ex in that range across your entitled markets, for 500 credits per request. Declared dividends appear once the source reports them, so a window that reaches into the next few weeks works as an ex-dividend calendar.

curl 'https://api.ohlc.io/v1/dividends?from=2026-10-05&to=2026-10-09&exchanges=XNYS,XNAS' \
  -H "Authorization: Bearer $OHLC_API_KEY"

Point in time and revisions

as_of returns the dividend history as it was known at the end of a past UTC day, which keeps backtests free of look-ahead. known_from and known_to select records by when a revision became known. GET /v1/corporate-actions returns the same dividends alongside splits in one stream if you want a single table of actions.

Common uses

• Tracking income from a portfolio by pay date
• Alerting before a holding goes ex-dividend
• Screening for long dividend-increase streaks or steady five-year growth
• Backtesting with dividends reinvested, using total_return prices

Plans and coverage

Dividends and corporate actions are included on every plan, Free included, for the symbols and history depth your plan allows: 5 years on Free and Developer, 15 on Pro and full history on Commercial and Scale. U.S. stocks and ETFs are covered from Developer up, and listings in Canada, the UK, France, the Netherlands and Australia from Pro up. Pro and above also receive a nightly U.S. corporate-actions flat file.

curl 'https://api.ohlc.io/v1/dividends?symbols=XNYS:JNJ&order=desc&limit=1' \
  -H "Authorization: Bearer $OHLC_API_KEY"

{
  "data": [
    {
      "security_id": "01M35XSMJQGQD66XDX1R38FJDM",
      "instrument_id": "01M35XSMJQGQD66XDX1R38FJDM",
      "symbol": "XNYS:JNJ",
      "exchange_mic": "XNYS",
      "action_type": "cash_dividend",
      "ex_date": "2026-08-25",
      "record_date": "2026-08-25",
      "pay_date": "2026-09-08",
      "effective_at": null,
      "announced_at": null,
      "declaration_date": "2026-07-15",
      "frequency": "Quarterly",
      "is_cancelled": false,
      "legs": [
        {
          "sequence": 0,
          "resulting_security_id": null,
          "cash_amount": "1.34",
          "currency_code": "USD",
          "ratio_numerator": null,
          "ratio_denominator": null,
          "attributes": { "declaration_date": "2026-07-15", "frequency": "Quarterly" }
        }
      ],
      "frequency_per_year": 4,
      "distribution_type": "recurring",
      "split_adjusted_amount": "1.34",
      "historical_adjustment_factor": "0.995092294169352475827717"
    }
  ],
  "meta": { "timezone": "UTC", "as_of": "2026-10-03T15:04:50Z", "next_cursor": null }
}