# x402stock Dividend Calendar API > x402stock Dividend Calendar API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13). Returns a paginated calendar of upcoming or historical stock dividend events with ex-dividend, pay, record, and declaration dates, cash amounts, and frequency details. ## Facts - Endpoint: GET https://x402stock.xyz/api/v1/dividend-calendar?utm_source=zero.xyz - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-10-13 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402stock-dividend-calendar-api-48342061 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OHedmU6OcEX1KbFJLlLOS Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability x402stock-dividend-calendar-api-48342061 ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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=`. ## Output 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. ## Request schema (JSON Schema) ```json { "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": { … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } ] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-dividend-calendar-api-48342061/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)