Dividend API Documentation

Build dividend-focused products with a REST API that currently covers 19,600+ symbols.

Base URL

https://divv-api-production.up.railway.app/v1
Open Interactive Reference

Endpoints

Health

GET/v1/health

Health check endpoint (no API key required)

Stocks

GET/v1/stocks

List stocks and ETFs with filters

GET/v1/stocks/{symbol}

Get core stock snapshot

GET/v1/stocks/{symbol}/quote

Comprehensive quote and dividend metrics

GET/v1/stocks/{symbol}/fundamentalsStarter+

Fundamentals endpoint

GET/v1/stocks/{symbol}/metrics

Dividend-focused metrics

GET/v1/stocks/{symbol}/dividendsStarter+

Dividend history for a symbol

GET/v1/stocks/{symbol}/splits

Historical stock split events

Dividends

GET/v1/dividends/calendar

Upcoming dividend payment dates

GET/v1/dividends/history

Historical dividends across symbols

GET/v1/dividends/ex-dates

Upcoming ex-dividend dates

GET/v1/dividends/payment-dates

Upcoming payment dates with amount filter

Prices

GET/v1/prices/{symbol}

Historical OHLCV data

GET/v1/prices/{symbol}/latest

Latest available price snapshot

ETFs

GET/v1/etfs

List ETFs with yield/expense filters

GET/v1/etfs/{symbol}

ETF detail view

GET/v1/etfs/{symbol}/holdings

ETF holdings with pagination

Screeners

GET/v1/screener

Generic dividend screener

GET/v1/screener/high-yield

High-yield screener

GET/v1/screener/dividend-growth

Dividend growth screener

GET/v1/screener/dividend-aristocrats

25+ year growth streak screener

GET/v1/screener/dividend-kings

50+ year growth streak screener

Search, Compare, and Sectors

GET/v1/search

Search by symbol or company name

GET/v1/compare

Side-by-side comparison for up to 10 symbols

GET/v1/sectors

Sector-level dividend stats

GET/v1/sectors/{sector}

Sector detail and dividend payers

Bulk (Tier-gated)

GET/v1/bulk/quotesPro+

Bulk quote lookup (up to 100 symbols)

GET/v1/bulk/metricsPro+

Bulk metrics lookup (up to 100 symbols)

GET/v1/bulk/dividendsPro+

Bulk dividend metrics (up to 100 symbols)

Response Shape

{
  "data": { ... },
  "meta": {
    "total": 100,
    "limit": 50,
    "returned": 50
  }
}

Next

  • Review authentication at /api/authentication
  • Use endpoint-specific pages in the left navigation for query parameter details