SmarterDividends

One U.S.-listed stock, ETF or fund's dividend record: forward yield, annual dividend, payout frequency, payout ratio, years of consecutive increases, A-F dividend safety grade, next ex-dividend and pay dates, fair value estimate and its dividend raises and cuts, newest first. Use for questions like "does Coca-Cola pay a dividend", "when is O's next ex-dividend date" or "has PepsiCo ever cut its dividend".

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "pattern": "^[A-Za-z0-9.\\-]{1,10}$",
      "description": "Ticker symbol, such as KO, O, SCHD or JEPQ."
    },
    "history_limit": {
      "default": 12,
      "description": "How many raises and cuts to return, newest first (0-100).",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search U.S.-listed stocks, ETFs and funds by company or fund name or ticker. Dividend payers and larger companies come first. Use it to turn a name like "Realty Income" or "JPMorgan Nasdaq premium income" into a ticker for get_dividend_profile.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Company or fund name, or part of a ticker."
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every U.S.-listed dividend going ex on one date, with the amount, pay date, yield, safety grade and change from the previous payment, plus the last day to buy the shares and still get the dividend. Defaults to today; dates up to 120 days ahead include announced dividends.

{
  "type": "object",
  "properties": {
    "date": {
      "description": "Ex-dividend date, YYYY-MM-DD. Defaults to today (UTC).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "default": 100,
      "description": "Maximum dividends to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every dividend increase, cut, suspension, special dividend and new dividend among U.S.-listed companies going ex in one week, with the old and new amount, percent change, growth streak and the safety score the company held beforehand. Defaults to the last 7 days.

{
  "type": "object",
  "properties": {
    "week": {
      "description": "Any date in the week wanted, YYYY-MM-DD (from 2026-06-01). Omit for the last 7 days.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "description": "Only this kind of change.",
      "type": "string",
      "enum": [
        "increase",
        "cut",
        "special",
        "initiation",
        "suspension",
        "resumption"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Distributions of option-income and covered-call ETFs such as YieldMax (MSTY, TSLY), Roundhill WeeklyPay, JPMorgan JEPI and JEPQ, NEOS, Global X and Defiance: the latest payout and its change from the previous one, the next declared payout, payment frequency, annualized distribution rate, trailing 12-month yield and one-year total return.

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "One fund's ticker, such as MSTY or JEPQ.",
      "type": "string",
      "pattern": "^[A-Za-z0-9.\\-]{1,10}$"
    },
    "family": {
      "description": "Only funds from this issuer family.",
      "type": "string",
      "enum": [
        "yieldmax",
        "roundhill",
        "neos",
        "jpmorgan",
        "goldman-sachs",
        "global-x",
        "defiance",
        "rex",
        "graniteshares",
        "amplify"
      ]
    },
    "sort": {
      "default": "distribution_rate",
      "type": "string",
      "enum": [
        "distribution_rate",
        "total_return",
        "symbol"
      ]
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Companies that declare their first dividend increase of the year in the same calendar month most years, from the last five complete years: how many years matched, the last and typical raise, and whether this year's raise has been declared yet. Ask by month (1-12) or by ticker.

{
  "type": "object",
  "properties": {
    "month": {
      "description": "Calendar month, 1 = January.",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "symbol": {
      "description": "One company's ticker instead of a month.",
      "type": "string",
      "pattern": "^[A-Za-z0-9.\\-]{1,10}$"
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

U.S.-listed stocks that paid a dividend in a given calendar month over the last year, split into quarterly payers (including off-cycle schedules), semiannual and annual payers, and monthly payers. Useful for building a portfolio that pays every month. Largest companies first.

{
  "type": "object",
  "properties": {
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Calendar month, 1 = January."
    },
    "schedule": {
      "default": "quarterly",
      "description": "Which payers to list: quarterly, monthly, semiannual/annual (occasional), or all.",
      "type": "string",
      "enum": [
        "quarterly",
        "monthly",
        "occasional",
        "all"
      ]
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "month"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}