API Reference

Implemented endpoints in the current release

Base URL

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

System

GET
/v1/health

Service health status (no API key required)

Stocks

GET
/v1/stocks

List and filter stocks/ETFs

GET
/v1/stocks/{symbol}

Get stock snapshot

GET
/v1/stocks/{symbol}/quote

Comprehensive quote

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

Fundamentals

GET
/v1/stocks/{symbol}/metrics

Dividend metrics

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

Dividend history

GET
/v1/stocks/{symbol}/splits

Split history

Dividends

GET
/v1/dividends/calendar

Upcoming payment-date calendar

GET
/v1/dividends/history

Historical dividends by symbol list

GET
/v1/dividends/ex-dates

Upcoming ex-dividend dates

GET
/v1/dividends/payment-dates

Upcoming payment dates

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

Dividend Aristocrats screener

GET
/v1/screener/dividend-kings

Dividend Kings screener

ETFs

GET
/v1/etfs

List ETFs with filters

GET
/v1/etfs/{symbol}

ETF details

GET
/v1/etfs/{symbol}/holdings

ETF holdings

Prices

GET
/v1/prices/{symbol}

Historical OHLCV prices

GET
/v1/prices/{symbol}/latest

Latest available price point

Search, Compare, Sectors

GET
/v1/search

Search by symbol/company

GET
/v1/compare

Compare up to 10 symbols

GET
/v1/sectors

List sectors with stats

GET
/v1/sectors/{sector}

Sector details and top payers

Bulk (Tier-gated)

GET
/v1/bulk/quotesPro+

Bulk quote lookup

GET
/v1/bulk/metricsPro+

Bulk metrics lookup

GET
/v1/bulk/dividendsPro+

Bulk dividend lookup

Detailed Endpoint Docs

Parameters, examples, and access-tier notes are available in the API docs section.

View API Docs