Stock Dividend History & Yield (by Symbol)

omnial/get-stock-dividend-history

Given a stock symbol, returns its dividend profile: ex-dividend date, dividend yield, annualized dividend, P/E ratio, payout ratio, and the full history of past dividend payments (date, type, amount, declaration/record/payment dates, currency). For a symbol that Nasdaq does not track dividend history for -- observed on an ETF -- every field comes back as the literal string 'N/A' alongside an explanatory message, rather than an error.

activeper callv2

Price

Up to $0.0137 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Nasdaq

Data from Nasdaq.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/get-stock-dividend-history" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/get-stock-dividend-history" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/get-stock-dividend-history", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/get-stock-dividend-history", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0137

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Stock symbol (e.g. AAPL)."
    },
    "asset_class": {
      "type": "string",
      "description": "Asset class: stocks, etf, mutualfunds."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": [
            "string",
            "null"
          ],
          "description": "Null on a normal Nasdaq-listed symbol (e.g. AAPL). A short explanatory string, e.g. 'Dividend History for Non-Nasdaq symbols is not available', on a symbol the endpoint has no dividend data for (observed on the SPY ETF) -- read this before trusting the 'N/A' fields below."
        },
        "dividend": {
          "type": "object",
          "properties": {
            "yield": {
              "type": "string",
              "description": "Formatted percentage string, e.g. '0.32%', or 'N/A'."
            },
            "history": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Usually null."
                },
                "rows": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "e.g. 'Cash', the only value observed."
                      },
                      "amount": {
                        "type": "string",
                        "description": "Formatted currency string, e.g. '$0.27'."
                      },
                      "currency": {
                        "type": "string",
                        "description": "ISO currency code, e.g. 'USD'."
                      },
                      "recordDate": {
                        "type": "string",
                        "description": "e.g. '08/10/2026'."
                      },
                      "exOrEffDate": {
                        "type": "string",
                        "description": "e.g. '08/10/2026'."
                      },
                      "paymentDate": {
                        "type": "string",
                        "description": "e.g. '08/13/2026', or 'N/A' on older rows."
                      },
                      "declarationDate": {
                        "type": "string",
                        "description": "e.g. '07/30/2026', or 'N/A' on older rows."
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "One entry per historical dividend payment, most recent first. 84 entries observed on a real Nasdaq-listed stock going back to 1988; absent when the symbol has no dividend history."
                }
              },
              "description": "Absent/empty when the endpoint has no dividend data for the symbol (observed on the SPY ETF, where the raw `dividends.rows` value is null rather than an array) -- not an error condition, see `data.message`.",
              "additionalProperties": true
            },
            "payoutRatio": {
              "type": "string",
              "description": "Formatted numeric string, e.g. '55.07', or 'N/A'."
            },
            "headerValues": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "value": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "description": "A 4-entry display summary on every real call observed: Ex-Dividend Date, Dividend Yield, Annual Dividend, and P/E Ratio. The first three duplicate the scalar fields above; P/E Ratio is not available anywhere else in this response. All four values come back as the literal string 'N/A' on a symbol with no dividend data."
            },
            "exDividendDate": {
              "type": "string",
              "description": "e.g. '08/10/2026', or the literal string 'N/A' when unavailable."
            },
            "annualizedDividend": {
              "type": "string",
              "description": "Formatted numeric string, e.g. '1.08', or 'N/A'."
            },
            "dividendPaymentDate": {
              "type": "string",
              "description": "e.g. '08/13/2026', or the literal string 'N/A' when unavailable."
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "Typically 'success'."
    }
  },
  "description": "The dividend record.",
  "additionalProperties": true
}