tickerbot.io
Data › Signals › Fundamentals › Valuation

dividend_yield

Forward dividend yield as a fraction (0.025 = 2.5%). Null for companies that pay none.

Facts

A numeric signal: screen on it with a comparison operator (dividend_yield > 0.15). It's null on tickers it doesn't apply to.

definitionLive: dividend yield as a fraction, as our data provider reports it. Earlier daily history: the latest payment × payments per year ÷ price, with the payment on today's share basis. Null for a company that pays no dividend, and once a payer misses 1.5 payment periods plus 14 days.
typenumeric
unitfraction
refreshpost-close daily
grains1d
asset classesUS equities
coverageall tickers
historyfull · since 2003
nullableyes

Examples

Screen on it

curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "dividend_yield > 0.15",
    "order": "dividend_yield"
  }'

Backtest it on a past date

curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "dividend_yield > 0.15",
    "asof": "2026-08-17",
    "order": "dividend_yield"
  }'

Get an alert when a ticker starts matching

curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "dividend_yield > 0.15",
    "target_url": "https://example.com/hooks/tickerbot"
  }'

Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.

Its history

curl "https://api.tickerbot.io/v2/tickers/NVDA/history?select=close,dividend_yield" \
  -H "Authorization: Bearer YOUR_KEY"