# x402stock Dividends

> x402stock Dividends is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns historical cash dividend records for a given stock ticker, including amount, currency, type, frequency, and key dates (declaration, ex-dividend, record, pay), sorted most recent first.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/dividends/:ticker?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-dividends-96a9587e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SYYwjd7dbZK2on1PUjDCM

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-dividends-96a9587e
```

Example prompt: Can you pull up the dividend history for Coca-Cola (KO) — I want to see the last 20 payments including the ex-dividend dates, pay dates, and amounts?

## When to prefer this

Choose this endpoint when you need structured, per-payment dividend history for a US-listed stock or ETF — including exact dates and amounts — rather than a summary yield figure. It is ideal for income analysis, DRIP planning, dividend growth tracking, or comparing payout consistency. Prefer it over general stock quote endpoints when dividend-specific data (ex-dates, pay dates, declaration dates) is required. No API key needed; pay $0.01 USDC per call via x402.

## Known failure modes

- Unknown or invalid ticker symbol returns empty results or 404
- Ticker exists but has no dividend history (e.g. non-dividend-paying growth stocks) returns empty list
- limit parameter out of range returns validation error
- Payment failure via x402 results in 402 response and no data returned
- Network timeout or upstream data source unavailability returns 5xx error

## How this service works

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.

## Output

A list of dividend records for the requested ticker, sorted most recent first. Each record includes the dividend amount and currency, dividend type (e.g. cash, special), payment frequency, and four key dates: declaration date, ex-dividend date, record date, and pay date. The number of records returned is controlled by the optional limit parameter (default 10, max 1000).

## 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"
    },
    "pathParams": {
     "type": "object",
     "ticker": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 1000,
       "exclusiveMinimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-dividends-96a9587e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)