Stocks

The Stocks endpoints provide access to stock and ETF data, including dividend information, company profiles, and pricing data.

GETList stocks

/v1/stocks

List all available stocks with optional filtering. Returns a paginated list of stocks matching the specified criteria.

Parameters

Name	Type	Description
has_dividends	boolean	Only show dividend-paying stocks
min_yield	float	Minimum dividend yield %
max_yield	float	Maximum dividend yield %
sector	string	Filter by sector
exchange	string	Filter by exchange (NASDAQ, NYSE, etc.)
type	string	"stock", "etf", or "trust"
limit	integer	Results per page (max 1000)
cursor	string	Pagination cursor

Returns

Returns a list object containing stock data.

GETGet stock details

/v1/stocks/{symbol}

Retrieve detailed information for a specific stock. Supports expansion of related data via the expand parameter.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol (e.g., "AAPL")

Query Parameters

Name	Type	Description
expand	string	Comma-separated fields to expand: company,dividends,prices

Returns

Returns a stock detail object with company info, pricing data, and dividend information.

GETNEWGet stock quote (GOOGLEFINANCE parity)

/v1/stocks/{symbol}/quote

✨ 100% GOOGLEFINANCE() Parity

This endpoint provides complete feature parity with Google Sheets GOOGLEFINANCE() function, plus superior dividend data that GOOGLEFINANCE doesn't provide.

Get real-time stock quote with all fundamental data, price metrics, and moving averages in a single API call.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol (e.g., "AAPL")

GOOGLEFINANCE Equivalent Attributes

priceCurrent price

priceopenOpening price

highToday's high

lowToday's low

volumeVolume

marketcapMarket cap

peP/E ratio

epsEarnings per share

high5252-week high

low5252-week low

changePrice change

changepctChange %

sharesShares outstanding

avgvolAverage volume

sma5050-day moving avg

sma200200-day moving avg

dividendyieldDividend yield

Response Fields

Returns a comprehensive quote object with:

Price Data: price, open, dayHigh, dayLow, previousClose, change, changePercent
Volume: volume, avgVolume
Moving Averages: priceAvg50 (SMA50), priceAvg200 (SMA200)
52-Week Range: yearHigh, yearLow
Fundamentals: marketCap, peRatio, eps, sharesOutstanding
Company Info: company, exchange, sector
Dividend Data: dividendYield, dividendAmount (superior to GOOGLEFINANCE)

Example Request

curl "https://api.divv.io/v1/stocks/AAPL/quote"

Coverage & Updates

📊 Coverage: 19,600+ stocks with fundamental data
🕐 Update Frequency: Daily at 5 PM EST (after market close)
⚡ Update Speed: 1-5 minutes for 16,000+ symbols

GETGet stock fundamentals

/v1/stocks/{symbol}/fundamentals

Get detailed fundamental metrics for a stock. Returns company fundamentals including market cap, P/E ratio, sector info, and more.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol (e.g., "AAPL")

Returns

Returns a fundamentals object with the following fields:

Market capitalization
P/E ratio
Payout ratio
Employee count
IPO date
Sector & industry
Website URL
Country

GETGet dividend metrics

/v1/stocks/{symbol}/metrics

Get detailed dividend metrics and consistency data. Returns dividend yield, growth rates, payout ratio, and consistency metrics including Dividend Aristocrat/King status.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol (e.g., "JNJ", "T")

Returns

Returns dividend metrics including:

Current dividend yield
Annual dividend amount
Payment frequency
Payout ratio
5-year growth rate
Consecutive years of increases - Track dividend growth streaks
Consecutive payment count - Total dividend payments
is_dividend_aristocrat - 25+ years of consecutive increases
is_dividend_king - 50+ years of consecutive increases

GETGet stock split history

/v1/stocks/{symbol}/splits

Get historical stock split events for a symbol. Returns all stock splits with split ratios and dates.

Path Parameters

Name	Type	Description
symbol	string	Stock symbol

Query Parameters

Name	Type	Description
limit	integer	Max results (default 50, max 200)

Returns

Returns a list of stock splits with date, ratio, and split factors.