{"uid":"cap_p2T25e7jQIEkXCdWfvIRD","slug":"finance-toon-haus-9523e068","name":"finance.toon.haus Stock Dividends","description":"Yield, rate, ex-date, 5yr history","url":"https://finance.toon.haus/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":"KO"}}},"response":{"ticker":"KO","history":[{"date":"2021-06-14","amount":0.42},{"date":"2021-09-14","amount":0.42},{"date":"2021-11-30","amount":0.42},{"date":"2022-03-14","amount":0.44},{"date":"2022-06-14","amount":0.44},{"date":"2022-09-15","amount":0.44},{"date":"2022-11-30","amount":0.44},{"date":"2023-03-16","amount":0.46},{"date":"2023-06-15","amount":0.46},{"date":"2023-09-14","amount":0.46},{"date":"2023-11-30","amount":0.46},{"date":"2024-03-14","amount":0.485},{"date":"2024-06-14","amount":0.485},{"date":"2024-09-13","amount":0.485},{"date":"2024-11-29","amount":0.485},{"date":"2025-03-14","amount":0.51},{"date":"2025-06-13","amount":0.51},{"date":"2025-09-15","amount":0.51},{"date":"2025-12-01","amount":0.51},{"date":"2026-03-13","amount":0.53}],"payoutRatio":0.64779997,"dividendRate":2.12,"dividendYield":0.026400002,"exDividendDate":"2026-06-15","fiveYearAvgDividendYield":2.89}},"exampleRequest":{"ticker":"KO"},"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_GstnaES7Bfwz_BqlAKMdp","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 symbol","exampleAgentPrompt":"What's the current dividend yield, rate, and ex-date for Coca-Cola (KO), and can you show me its 5-year dividend history?","exampleUseCases":[{"title":"Build a dividend stock screening tool","prompt":"I want to create a list of high-yield dividend stocks from my portfolio. Can you pull the current yields and dividend rates for Apple, Microsoft, Coca-Cola, Johnson & Johnson, and Procter & Gamble so I can compare which ones are paying the most income?"},{"title":"Track upcoming dividend payment dates","prompt":"Help me figure out when I should expect dividend payments coming in. Can you check the ex-dividend dates for Verizon, AT&T, and Chevron so I know which months I'll be receiving payouts?"},{"title":"Analyze dividend sustainability trends","prompt":"I'm considering buying Walmart but want to make sure their dividends are stable. Can you show me the 5-year dividend history and current yield so I can see if they've been consistently paying and growing their dividends over time?"}],"resultDescription":"Returns structured dividend data including the dividend yield percentage, dividend rate (dollar amount per share), ex-dividend date, and a 5-year historical record of dividend payments for the queried stock symbol.","failureModes":["Invalid or unknown ticker symbol returns an error or empty result","Non-dividend-paying stocks may return null or zero values for yield/rate","Network timeout or service unavailability returns HTTP 5xx","Payment failure (insufficient USDC balance) blocks the request via x402 protocol","Missing required query parameter (stock ticker) returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need dividend-specific data for a stock, including yield, rate, ex-date, and historical dividend trends over 5 years. Prefer this over general quote endpoints when the user's focus is income investing, dividend screening, or tracking payout history rather than price data.","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}