{"uid":"cap_fi6oUgsLRMrrCuizChvTW","slug":"dividends-corporate-actions-cbb9b138","name":"Dividends & Corporate Actions","description":"Dividend and corporate-action history for a US stock in one call: forward/trailing yield and payout ratio, next ex-dividend/payment date (never a stale already-elapsed date), last dividend paid, up to 12 most recent dividend payments, and stock split history. A non-payer returns clean nulls, not an error. From real Yahoo Finance data. $0.005/call.","url":"https://www.x402financialdata.com/dividends/:ticker","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"Stock ticker symbol, e.g. AAPL, JNJ, KO"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iTr8PLcL8T43-VLOOfOpa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns dividend yield, payout ratio, upcoming ex-dividend/payment dates, recent dividend history, and stock split history for a US stock ticker.","exampleAgentPrompt":"What's the current dividend yield, payout ratio, and next ex-dividend date for Johnson & Johnson (JNJ), and can you also show me its last 12 dividend payments and any stock split history?","exampleUseCases":[{"title":"Income investor dividend screening","prompt":"I'm building a dividend portfolio — can you pull the forward yield, payout ratio, and next ex-dividend date for Coca-Cola (KO) so I can decide if it fits my income strategy?"},{"title":"Portfolio dividend calendar tracking","prompt":"When is Microsoft's next ex-dividend date and payment date, and how much was the last dividend they paid? I want to plan my cash flow for the quarter."},{"title":"Checking if a stock pays dividends","prompt":"Does Tesla pay any dividends? If not, just tell me it's a non-payer — and if it does, show me the recent history and any splits."}],"resultDescription":"Returns a JSON object with forward and trailing dividend yield, payout ratio, next ex-dividend date, next payment date, last dividend amount, an array of up to 12 recent dividend payments with dates and amounts, and a stock split history array. Non-dividend-paying stocks return clean null values rather than errors.","failureModes":["Invalid or unrecognized ticker symbol returns an error response","Ticker for a foreign (non-US) stock may return no data or nulls","Network timeout or upstream Yahoo Finance outage causes failure","Payment not included or invalid x402 payment header returns 402 error"],"whenToPreferThis":"Choose this endpoint when you need comprehensive dividend and corporate action data — yield, payout ratio, upcoming dates, payment history, and splits — in a single call for a US stock. It is preferable to building your own scraper or using multiple endpoints, and it cleanly handles non-payers with nulls rather than errors. Best suited for dividend-focused investment research, income portfolio tracking, or ex-date calendaring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:09.315Z","isFirstParty":false}