{"uid":"cap_86FRZP3k0ok-Aatc0DsB2","slug":"us-stock-cash-dividend-history-2e322bf4","name":"US Stock Cash Dividend History","description":"Cash dividend history for a US stock — ex-dividend/pay/record dates, per-share amount and payout frequency.","url":"https://marketdata.use.x402atlas.com/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","required":["ticker"],"properties":{"limit":{"type":"integer","maximum":50000,"minimum":1,"description":"Max results returned"},"ticker":{"type":"string","description":"US stock ticker, e.g. AAPL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","ticker","count","dividends"],"properties":{"count":{"type":"integer","description":"Number of dividends returned."},"ticker":{"type":"string","description":"Echo of the requested ticker."},"dividends":{"type":"array","items":{"type":"object","required":["cash_amount","currency","frequency"],"properties":{"currency":{"type":"string","description":"ISO currency code."},"pay_date":{"type":"string","format":"date"},"frequency":{"type":"integer","description":"Payouts per year (e.g. 4 for quarterly)."},"cash_amount":{"type":"number","description":"Per-share cash amount."},"record_date":{"type":"string","format":"date"},"declaration_date":{"type":"string","format":"date"},"ex_dividend_date":{"type":"string","format":"date"},"distribution_type":{"type":"string","description":"e.g. recurring, special."}}},"description":"Cash dividend history, most recent first."},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp when this bridge queried the upstream."}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"ticker":"AAPL","dividends":[{"currency":"USD","pay_date":"2025-08-14","frequency":4,"cash_amount":0.26,"ex_dividend_date":"2025-08-11","distribution_type":"recurring"}],"queried_at":"2026-07-06T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_psEoAnGO9MwI99xR9lWUD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns cash dividend history for a US stock ticker, including ex-dividend dates, pay dates, record dates, per-share amounts, and payout frequency.","exampleAgentPrompt":"Pull up the full cash dividend history for AAPL — I want to see the ex-dividend dates, pay dates, record dates, per-share amounts, and how often they pay out.","exampleUseCases":[{"title":"Track dividend growth over time","prompt":"Can you pull the full dividend history for KO and show me how the per-share payout has changed over the years? I want to see if they've been consistently growing their dividend."},{"title":"Find next ex-dividend date","prompt":"Look up the recent dividend records for JNJ — I want to know when the last ex-dividend date was and figure out roughly when the next one might be so I can plan my trades around it."},{"title":"Compare payout frequency across stocks","prompt":"Grab the dividend history for T, MCD, and PG and tell me how often each one pays out — I'm trying to build a monthly income portfolio and want to see which ones pay quarterly versus more frequently."}],"resultDescription":"A list of historical cash dividend records for the specified US stock ticker, each containing the ex-dividend date, pay date, record date, dividend amount per share, and payout frequency (e.g. quarterly, annual). Up to 100 records by default, up to 5000 with the limit parameter.","failureModes":["Invalid or unknown ticker symbol returns empty result or error","Non-US ticker symbols may not be supported","limit parameter exceeding 5000 returns a validation error","Payment failure (402) if USDC balance is insufficient","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need historical cash dividend data for a US-listed stock, including income analysis, yield calculations, dividend growth tracking, or identifying ex-dividend and pay dates for trading strategies. Prefer this over general reference endpoints when dividend-specific corporate action data is the primary need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:57.116Z","isFirstParty":false}