Dividend API Documentation

Welcome to the Dividend API documentation. Build powerful dividend investing applications with our production-grade REST API.

Getting Started

The API is currently running at https://api.divv.io

View Interactive API Reference

Base URL

https://api.divv.io/v1

Key Features

Comprehensive Data

Access 19,600+ stocks with real-time prices, dividend history, and future payment schedules

Dividend Aristocrats & Kings

NEW

Instantly identify stocks with 25+ or 50+ years of consecutive dividend increases - no manual calculation needed

Complete Fundamentals

NEW

Market cap, P/E ratios, payout ratios, sector/industry classifications, and company profiles

ETF Research Tools

NEW

AUM tracking, expense ratio comparison, strategy classification (80+ types), and holdings composition

Intraday Data

NEW

Hour-by-hour OHLCV data with VWAP for better entry timing and volume analysis

High Performance

Sub-100ms response times with intelligent caching and materialized database views

Advanced Screeners

Pre-built screeners for high-yield, monthly payers, aristocrats, kings, and high dividend growth stocks

Portfolio Analytics

Calculate dividend projections, reinvestment scenarios, and portfolio performance metrics

Quick Example

Get high-yield dividend stocks with a simple GET request:

Available Endpoints

Stocks & Fundamentals

GET/v1/stocks

List all stocks with optional filtering

GET/v1/stocks/{symbol}

Get detailed information for a specific stock

GET/v1/stocks/{symbol}/fundamentalsv1.2.0

📊 NEW: Get stock fundamentals (market cap, P/E ratio, sector, industry)

GET/v1/stocks/{symbol}/metricsv1.2.0

📊 NEW: Get dividend metrics with Aristocrat/King status

GET/v1/stocks/{symbol}/splitsv1.2.0

📊 NEW: Get historical stock split events

Dividend Data

GET/v1/dividends/{symbol}

Get dividend history for a stock

GET/v1/dividends/{symbol}/upcoming

Get upcoming dividends for a stock

GET/v1/dividends/calendar

Get upcoming dividend events and payment dates

Pre-built Screeners

GET/v1/screeners/high-yield

Pre-built screener for high-yield dividend stocks

GET/v1/screeners/monthly-payers

Find stocks that pay monthly dividends

GET/v1/screeners/dividend-aristocratsv1.2.0

📊 NEW: Find stocks with 25+ years of consecutive increases

GET/v1/screeners/dividend-kingsv1.2.0

📊 NEW: Find elite stocks with 50+ years of consecutive increases

GET/v1/screeners/high-growth-dividendsv1.2.0

📊 NEW: Find stocks with strong 5-year dividend growth

ETF Research

GET/v1/etfs

List all ETFs with filtering

GET/v1/etfs/{symbol}

Get ETF details with AUM and expense ratio

GET/v1/etfs/{symbol}/holdings

Get ETF holdings composition

GET/v1/etfs/strategies

Get ETF strategy classifications (80+ types)

🔍 Search

GET/v1/searchv1.2.0

Search stocks by symbol, company name, or sector with fuzzy matching

⚡ Bulk OperationsPRO+

POST/v1/bulk/stocksv1.2.0

Fetch data for up to 1,000 symbols in a single request (10-100x fewer API calls)

Portfolio Analytics

POST/v1/analytics/portfolio/income

Calculate dividend income projections

POST/v1/analytics/portfolio/yield

Analyze portfolio yield metrics

Utility

GET/v1/search

Search stocks by symbol, company name, or sector

Response Format

All responses follow a consistent JSON structure:

{
  "object": "list",
  "has_more": false,
  "cursor": null,
  "data": [
    {
      "id": "stock_aapl",
      "symbol": "AAPL",
      "company": "Apple Inc.",
      "exchange": "NASDAQ",
      "price": 185.50,
      "dividend_yield": 0.52
    }
  ]
}

Error Handling

Errors are returned with appropriate HTTP status codes and structured error objects:

{
  "error": {
    "type": "invalid_request_error",
    "message": "Symbol 'INVALID' not found",
    "param": "symbol",
    "code": "symbol_not_found"
  }
}

Next Steps

  • Browse the Core Resources section for detailed endpoint documentation
  • Check out Screeners for pre-built dividend stock filters
  • Explore Analytics for portfolio analysis features
  • Visit the Interactive API Reference to test endpoints