# x402stock.xyz Dividend History

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

Returns historical and recent dividend records for a given stock ticker, including cash amount, currency, dates, and dividend type.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/dividends/AAPL
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-50afdfd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_afG5vRVWeqlC_1fSlrKVQ

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-xyz-50afdfd0
```

Example prompt: Show me the last 20 dividend payments for AAPL, including the ex-dividend dates, pay dates, and cash amounts per share.

## When to prefer this

Use this endpoint when you need historical dividend data for a specific US-listed equity — especially ex-dividend dates, pay dates, and cash amounts per share. Prefer this over general ticker search endpoints when the user wants income/dividend-specific information rather than price or volume data.

## Known failure modes

- Unknown or delisted ticker returns empty dividends array or 404
- Limit parameter outside 1–1000 range causes validation error
- Ticker with no dividend history returns count:0 and empty array
- Payment failure (402) if USDC balance is insufficient
- Network timeout or upstream data source unavailability returns 5xx

## 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 JSON object containing the ticker symbol, an as_of timestamp, the data source, and an array of dividend records each with cash_amount, currency, dividend_type, frequency, declaration_date, ex_dividend_date, record_date, and pay_date, along with a total count of results returned.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 20
  }
 }
}
```

## 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": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 1000,
       "exclusiveMinimum": 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": [
      "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"
             },
             {
              "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-50afdfd0/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)