{"uid":"cap_-FGavJ6mm9YB8HPHz4_wr","slug":"agents-x402stock-xyz-x402stock-historical-dividends-by-ticker-07b4073e","name":"x402stock Historical Dividends by Ticker","description":"Historical cash dividends for a ticker: amount, currency, type, frequency, and the declaration / ex-dividend / record / pay dates. Most recent first. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.","url":"https://agents.x402stock.xyz/api/v1/dividends/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":10,"maximum":1000,"exclusiveMinimum":0},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["count","dividends"],"properties":{"count":{"type":"number"},"dividends":{"type":"array","items":{"type":"object","required":["cash_amount","currency","dividend_type","frequency","declaration_date","ex_dividend_date","record_date","pay_date"],"properties":{"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"pay_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"frequency":{"anyOf":[{"type":"number"},{"type":"null"}]},"cash_amount":{"type":"number"},"record_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"dividend_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"ex_dividend_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eq6NIC3baszX4spjW_CVd","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns historical cash dividend records for a US-listed ticker, including amount, currency, type, frequency, and all key dates (declaration, ex-dividend, record, pay), sorted most recent first.","exampleAgentPrompt":"Pull the last 20 dividend payments for KO — I want the cash amount, ex-dividend date, pay date, and whether they were regular or special dividends.","exampleUseCases":[{"title":"Income investor dividend research","prompt":"Show me the full dividend history for Realty Income (O) — I want the amounts, frequencies, and pay dates so I can see how consistent their monthly payouts have been."},{"title":"Ex-dividend date alert setup","prompt":"What's the most recent ex-dividend date and record date for Johnson & Johnson? I want to make sure I hold the stock in time to qualify."},{"title":"Dividend growth analysis","prompt":"Get me the last 10 years of dividend payments for Coca-Cola — I want to see how the cash amount has changed over time to evaluate their dividend growth rate."}],"resultDescription":"A JSON object containing the ticker, a count of returned records, and an array of dividend entries sorted most recent first. Each entry includes: cash_amount (float), currency (string or null), dividend_type (e.g. 'CD' for regular cash, 'SC' for special cash, or null), frequency (number of payments per year or null), declaration_date, ex_dividend_date, record_date, and pay_date (all ISO date strings or null). Also includes an as_of timestamp and source attribution.","failureModes":["Invalid or non-US ticker symbol returns an empty data array or error response","Ticker with no dividend history returns count: 0 and an empty dividends array","Limit parameter of 0 or negative integer rejected (exclusiveMinimum: 0)","Limit above 1000 rejected by schema validation","Payment failure via x402 results in 402 response before data is returned","Network timeout for illiquid or obscure tickers with sparse data"],"whenToPreferThis":"Use this endpoint when you need structured historical dividend data for a specific US-listed stock or ETF, including exact dates and amounts for income analysis, ex-dividend qualification checks, or dividend growth trend research. Prefer this over general financial data APIs when you need pay-per-call pricing with no API key setup, or when building autonomous agent workflows that only pay for the data actually consumed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-09T12:36:57.605Z","isFirstParty":false}