{"uid":"cap_OHedmU6OcEX1KbFJLlLOS","slug":"x402stock-dividend-calendar-api-48342061","name":"x402stock Dividend Calendar API","description":"Market-wide dividend calendar (no ticker needed). Per row: ticker, ex-dividend / record / pay / declaration dates, cash amount per share, currency, type, payments-per-year `frequency` + `frequency_label` (quarterly, monthly, weekly, one-time), and computed `annualized_amount`. Upcoming payments first. Filter `?from=`/`?to=` on ex-date, `?ticker=`, `?frequency=`, `?order=`, `?limit=`.","url":"https://x402stock.xyz/api/v1/dividend-calendar?utm_source=zero.xyz","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"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["order","limit"],"properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"limit":{"type":"integer","default":50,"maximum":1000,"exclusiveMinimum":0},"order":{"enum":["asc","desc"],"type":"string","default":"asc"},"ticker":{"type":"string","maxLength":16},"frequency":{"type":"integer","maximum":52,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","count","dividends"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"source":{"type":"string","const":"x402stock"},"dividends":{"type":"array","items":{"type":"object","required":["ticker","ex_dividend_date","pay_date","record_date","declaration_date","cash_amount","currency","dividend_type","frequency","frequency_label","annualized_amount"],"properties":{"ticker":{"type":"string"},"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"}]},"frequency_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"declaration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"ex_dividend_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"annualized_amount":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-07-30T14:00:00.000Z","count":2,"source":"x402stock","dividends":[{"ticker":"AMAX","currency":"USD","pay_date":"2026-07-31","frequency":12,"cash_amount":0.0743,"record_date":"2026-07-30","dividend_type":"CD","frequency_label":"monthly","declaration_date":"2026-04-24","ex_dividend_date":"2026-07-30","annualized_amount":0.8916},{"ticker":"AAPL","currency":"USD","pay_date":"2026-08-13","frequency":4,"cash_amount":0.27,"record_date":"2026-08-10","dividend_type":"CD","frequency_label":"quarterly","declaration_date":"2026-07-30","ex_dividend_date":"2026-08-10","annualized_amount":1.08}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NqgOg1CybFgl7Ru1a9xGz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated calendar of upcoming or historical stock dividend events with ex-dividend, pay, record, and declaration dates, cash amounts, and frequency details.","exampleAgentPrompt":"Pull the dividend calendar from x402stock for the next 30 days starting 2026-08-01 through 2026-08-31, sorted ascending by date, limited to 100 results — I want to see which stocks have ex-dividend dates coming up.","exampleUseCases":[{"title":"Weekly income investor dividend scan","prompt":"Give me all dividend events with ex-dividend dates between 2026-08-01 and 2026-08-07, sorted ascending, up to 50 results — I want to plan which stocks to hold going into next week."},{"title":"AAPL dividend history lookup","prompt":"Fetch the dividend history for AAPL from x402stock going back to 2025-01-01 through today, sorted descending, so I can see how their quarterly payouts have changed over time."},{"title":"Monthly dividend payer screening","prompt":"Get me up to 200 dividend calendar entries where the frequency is monthly, for the date range 2026-07-01 to 2026-09-30 sorted ascending — I'm building a list of monthly income stocks for my portfolio."}],"resultDescription":"A JSON object containing a timestamp (as_of), total count of matching dividends, and an array of dividend records each with ticker, ex-dividend date, pay date, record date, declaration date, cash amount per share, currency, dividend type code, payment frequency (integer and label), and annualized dividend amount.","failureModes":["Missing required 'order' or 'limit' query parameters returns a validation error","Date strings not matching YYYY-MM-DD pattern are rejected","Limit exceeding 1000 returns a schema validation error","Invalid ticker symbol returns an empty dividends array rather than an error","Payment failure or insufficient USDC balance results in a 402 Payment Required response","Frequency value outside 0-52 range is rejected","No dividends in the specified date range returns count:0 and empty array"],"whenToPreferThis":"Choose this endpoint when you need structured, date-ranged dividend event data for US stocks and ETFs — including ex-dividend, pay, record, and declaration dates alongside cash amounts and annualized figures. It is ideal for income investors, portfolio screeners, or agents that need to schedule around ex-dividend dates. Prefer it over general financial data APIs when you need no-account, pay-per-call access priced at $0.02 USDC via x402 on Base, with filtering by ticker, frequency, and date range in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:54:29.727Z","isFirstParty":false,"canonicalSlug":"x402stock-dividend-calendar-api-48342061"}