{"uid":"cap_mKedy8ddnJsWVoxv4WU0Y","slug":"finance-toonhaus-dev-b6fe7d97","name":"finance.toonhaus.dev Stock Dividends","description":"Yield, rate, ex-date, 5yr history","url":"https://finance.toonhaus.dev/api/stock/dividends","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ticker":"AAPL"}}},"response":{"ticker":"AAPL","history":[{"date":"2021-08-06","amount":0.22},{"date":"2021-11-05","amount":0.22},{"date":"2022-02-04","amount":0.22},{"date":"2022-05-06","amount":0.23},{"date":"2022-08-05","amount":0.23},{"date":"2022-11-04","amount":0.23},{"date":"2023-02-10","amount":0.23},{"date":"2023-05-12","amount":0.24},{"date":"2023-08-11","amount":0.24},{"date":"2023-11-10","amount":0.24},{"date":"2024-02-09","amount":0.24},{"date":"2024-05-10","amount":0.25},{"date":"2024-08-12","amount":0.25},{"date":"2024-11-08","amount":0.25},{"date":"2025-02-10","amount":0.25},{"date":"2025-05-12","amount":0.26},{"date":"2025-08-11","amount":0.26},{"date":"2025-11-10","amount":0.26},{"date":"2026-02-09","amount":0.26},{"date":"2026-05-11","amount":0.27}],"payoutRatio":0.1259,"dividendRate":1.08,"dividendYield":0.0036000002,"exDividendDate":"2026-05-11","fiveYearAvgDividendYield":0.5}},"exampleRequest":{"ticker":"AAPL"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QCv4cSlFB_kqXPTmngtOl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns dividend yield, rate, ex-date, and 5-year dividend history for a given stock","exampleAgentPrompt":"Can you pull up the dividend yield, current rate, ex-dividend date, and 5-year dividend history for ticker AAPL?","exampleUseCases":null,"resultDescription":"Returns structured dividend data including current dividend yield (as a percentage), annualized dividend rate, the most recent or upcoming ex-dividend date, and up to 5 years of historical dividend payments for the queried stock symbol.","failureModes":["Stock ticker not found or invalid — returns error or empty result","Stock pays no dividends — returns null or zero values for yield/rate","Network timeout or service unavailability — returns HTTP 5xx","Payment not processed or insufficient balance — returns HTTP 402","Missing required query parameters — returns HTTP 400 with validation error"],"whenToPreferThis":"Use this endpoint when you need specific dividend-focused data for a stock, including yield, rate, ex-date, and historical dividend payouts. Prefer this over generic stock quote endpoints when the user's question is specifically about dividend income, dividend history, or ex-dividend timing. Part of the finance.toonhaus.dev suite, so combine with sibling endpoints for analyst recommendations or insider transactions for a fuller investment picture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:49:23.238Z","isFirstParty":false}